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INTRODUCTION 


This manual is intended to supplement the information contained in the UNIX System User’s Manual and to provide 
an easy reference volume for those who must administer a UNIX System. Accordingly, only those commands and 
descriptions deemed appropriate for system administrators have been included here. 

This manual is divided into three sections: 

1. System Maintenance Commands and Application Programs 

7. Special Files. 

8. System Maintenance Procedures. 

Throughout this volume, each reference of the form name(lM), name{l), or name(S), refers to entries in this man¬ 
ual, while all other references to entries of the form name(N), where A is a number possibly followed by a letter, 
refer to entry name in Section N of the UNIX System User’s Manual. 

Section 1 (System Maintenance Commands and Application Programs) contains system maintenance programs such 
as fsck, mkfs, etc., which generally reside in the directory /etc; these entries carry a sub-class designation of “IM” 
for cross referencing reasons. 

Section? (Special Files) discusses the characteristics of each system file that actually refers to an input/output 
device. The names in this section generally refer to device names for the hardware, rather than to the names of the 
special files themselves. 

Section 8 (System Maintenance Procedures) discusses crash recovery and boot procedures, facility descriptions, etc. 

Each section consists of a number of independent entries of a page or so each. The name of the entry appears in the 
upper corners of its pages. Entries within each section are alphabetized, with the exception of the introductory entry 
that begins each section. The page numbers of each entry start at 1. Some entries may describe several routines, 
commands, etc. In such cases, the entry appears only once, alphabetized under its “major” name. 

All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its purpose. 

The SYNOPSIS part summarizes the use of the program being described. A few conventions are used, particu¬ 
larly in Section 1 (Commands): 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and program names found elsewhere in 
the manual (they are underlined in the typed version of the entries). 

Square brackets [ ] around an argument prototype indicate that the argument is optional. When an argu¬ 
ment prototype is given as “name” or “file”, it always refers to a file name. 

Ellipses ... are used to show that the previous argument prototype may be repeated. 

A final convention is used by the commands themselves. An argument beginning with a minus -, plus -I-, 
or equal sign = is often taken to be some sort of flag argument, even if it appears in a position where a file 
name could appear. Therefore, it is unwise to have files whose names begin with -, -I-, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) of usage, where appropriate. 

The PILES part gives the file names that are built into the program. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be produced. Messages that are intended 
to be self-explanatory are not listed. 
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The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, the suggested hx is also described. 

A table of contents and a permuted index precede Section 1. The permuted index contains entries from both the UNIX System 
User’s Manual and this volume, and on each line, the title of the entry to which that line refers is followed by the appropriate 
section number in parentheses. This is important because there is considerable duplication of names among the sections, arising 
principally from commands that exist only to exercise a particular system call. 

On most systems, all entries are available on-line via the nuin(l) command, q.v. 
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1. System Maintenance Commands and Application Programs 


intro.introduction to system maintenance commands and application programs 

abt.abort on-line diagnostics 

accept.allow/prevent LP requests 

acct.overview of accounting and miscellaneous accounting commands 

acctcms.command summary from per-process accounting records 

acctcon.connect-time accounting 

acctmerg.merge or add total accounting files 

acctprc.process accounting 

acctsh.shell procedures for accounting 

acuset.connect ACUs and communication lines 

atb.attach to an Address Translation Buffer 

bcopy .interactive block copy 

brc .system initialization shell scripts 

checkall.faster file system checking procedure 

chmap.change the diagnostic spooler map file 

chroot.change root directory for a command 

clri.clear i-node 

config.3b.configure a UNIX system 

config.dc.configure a UNIX system 

crash.examine system images 

cron.clock daemon 

dcopy.copy file systems for optimal access time 

devnm.device name 

df.report number of free disk blocks 

dgn.initiate on-line diagnostics 

don .device logically on, logically off or display status 

dskfmt.format and verify disk packs 

dstart.start, stop and hnd status of on-line diagnostics 

emulcntrl.perform 3270 emulation control functions 

emulload.load and start 3270 emulation script 

emulstat.get 3270 emulation controller/terminal status 

errdead.extract error records from dump 

errdemon.error-logging daemon 

errpt.process a report of logged errors 

errstop.terminate the error-logging daemon 

ff .list file names and statistics for a file system 

filesave.daily/weekly UNIX file system backup 

fine.fast incremental backup 

format.format and/or check RP06 and RM05 disk packs 

free.recover files from a backup tape 

fsck.hie system consistency check and interactive repair 

fsev.convert hies between PDP-11 and VAX-11/780 systems 

fsdb.hie system debugger 

fts .Field Test Set interface 

fuser.identify processes using a hie or hie structure 

fwtmp .manipulate connect accounting records 

getty.set terminal type, modes, speed, and line discipline 

init.process control initialization 

install.install commands 
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ipb.read the EAI Input Parameter Buffer 

killall.kill all active processes 

link .exercise link and unlink system calls 

Ipadmin.configure the LP spooling system 

Ipsched.start/stop the LP request scheduler and move requests 

mkboot.convert a.out file to boot image 

mkfs.construct a file system 

mknod.build special file 

mounf.mount and dismount file system 

msi.memory system diagnostic interface 

mvdir.move a directory 

ncheck.generate names from i-numbers 

newboot.load VTOC, prom patch, or Iboot 

nscloop.perform the NSC local network loopback functions 

nscmon.operationally control the NSC local network 

pcldaemon.PCL link monitor 

prm.send a Processor Recovery Message 

profiler.operating system profiler 

pwck.password/group file checkers 

reboof.reboot the system 

rmv .remove unit from service before on-line diagnostics 

rst.restore unit to service after on-line diagnostics 

runacct.run daily accounting 

sar.system activity report package 

setmnt.establish mount table 

setmrf.override system MRF action 

shutdown.terminate all processing 

ssr.print or modify the System Status Register 

St.synchronous terminal control 

sta.find sfafus of pending on-line diagnosfic requests 

stgetty.wait on synchronous login line for use 

sysdef.system definition 

unclean.uucp spool directory clean-up 

uusub .monitor uucp network 

vcf.VAX-11/780 configuration verification program 

vlx.VAX-11/780 LSI console floppy interface 

volcopy.copy file systems wifh label checking 

vpmc.dec.compiler for fhe virtual protocol machine 

vpmc.uSb.compiler for the virtual protocol machine 

vpmsave.save and print VPM event traces 

vpmset.connect/load VPM drivers and programmable communication devices 

vpmtest .test KMC lines 

wall .write to all users 

whodo.who is doing what 

x25pvc.install, remove, or get status for a BX.25 minor device or link 

7. Special Files 

intro.introduction to special files 

acu .Automatic Call Unit (ACU) interface 

cat.phototypesetter interface 

dgn.on-line diagnostic interface 

dmc.communications link with built-in DDCMP protocol 
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dmk.DM11-BA modem control multiplexor 

dsk.3B20S moving-head disk 

du.DU-11 synchronous line interface 

dz.DZ-11, DZ-11 /KMC-11B, DH-11 asynchronous multiplexers 

emulio. 3270 emulation interface 

err.error-logging interface 

gd.general driver for moving-head disks 

gt.general driver for tape drives 

hm .RM05 moving-head disk 

hp.RP04/RP05/RP06 moving-head disk 

hs.RH11/RJS03-RJS04 fixed-head disk file 

ht.TU16/TE16 magnetic tape interface 

kl.KL-11 or DL-11 asynchronous interface 

kmc.KMC-IIB/KMS11 microprocessor 

Ip.line printer 

mem .core memory 

mill.MLll solid-state disk 

nc .network control 

nsc.NSC adapter interface specification 

null.the null file 

osm.interface to UNIX system messages 

pci.parallel communications link interface 

prf.operating system profiler 

rf.RFl 1/RS11 fixed-head disk file 

rk.RK-11/RK03 or RK05 disk 

rl.RL-ll/RLOl disk 

rmSO.RM80 moving-head disk 

rp .RP-11/RP03 moving-head disk 

rp07 .RP07 non-removable medium moving-head disk 

St.synchronous terminal interface 

stermio.general synchronous terminal interface 

termio.general terminal interface 

tm.TMl 1/TUlO magnetic tape interface 

tn4.eight line asynchronous interface 

tn74.two line asynchronous interface 

tn83.console/printer interface 

tn85 .medium speed line printer controller 

trace.event-tracing driver 

tsl 1 .TS11 magnetic tape interface 

tty.controlling terminal interface 

tu78.TU78 magnetic tape interface 

un32 .magnetic tape interface 

un52 .magnetic tape interface 

un53.UN53/TN82 synchronous device interface 

vp.Versatec printer 

vpm.Virtual Protocol Machine 

x25 BX.25 network interface 


8. System Maintenance Procedures 


intro.introduction to system maintenance procedures 

3B20boot .3B20S bootstrap procedures 

3B20ops.3B20S console operations 
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TOboot.11/70 bootstrap procedures 

750ops.VAX-11/750 console operations 

780ops.VAX-11/780 console operations 

crash.dec.what to do when the system crashes 

crash.u3b.what to do when the system crashes 

diskboot.disk bootstrap programs 

eai.3B20S emergency action interface 

Idtape.load disk from tape procedures 

mk.how to remake the system and commands 

prm.3B20S Processor Recovery Messages 

rje.RJE (Remote Job Entry) to IBM 

romboot.special ROM bootstrap loaders 

tapeboot.magnetic tape bootstrap program 

trouble.trouble reporting system 

unixboot.UNIX startup and boot procedures 
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70boot: 11/70 bootstrap procedures.70boot(8) 

/functions of HP 2640 and 2621-series terminals.hp(l) 

handle special functions of HP 2640 and 2621-series/hp:.hp(l) 

archiver, hpio: HP 2645A terminal tape file.hpio(l) 

functions of DASI 300 and/ 300, 300s: handle special . 300(1) 

/special functions of DASI 300 and 300s terminals. 300(1) 

of DASI 300 and 300s/ 300, 300s: handle special functions . 300(1) 

functions of DASI 300 and 300s terminals./special. 300(1) 

functions, emulcntrl: perform 3270 emulation control.emulcntrl(lM) 

emulstat: get 3270 emulation/.emulstat(lM) 

emulio: 3270 emulation interface.emulio(7) 

emulload: load and start 3270 emulation script.emulload(lM) 

procedures. 3B20boot: 3B20S bootstrap .3B20boot(8) 

operations. 3B20ops: 3B20S console .3B20ops(8) 

3B20boot: 3B20S bootstrap procedures.3B20boot(8) 

3B20ops: 3B20S console operations.3B20ops(8) 

dis: 3B20S disassembler.dis(l) 

interface, eai: 3B20S emergency action .eai(8) 

dsk: 3B20S moving-head disk.dsk(7) 

produce C source listing from 3B20S object file, list: .list(l) 

Messages, prm: 3B20S Processor Recovery .prm(8) 

sys3b: 3B20S specific system calls.sys3b(2) 

system: format of 3B20S system description file.system(4) 

13tol, ltol3: convert between 3-byte integers and long/ .13tol(3C) 

comparison. diff3: 3-way differential file.diff3(l) 

Tektronix 4014 terminal. 4014: paginator for the .4014(1) 

paginator for the Tektronix 4014 terminal. 4014:. 4014(1) 

of the DASI 450 terminal. 450: handle special functions. 450(1) 

special functions of the DASI 450 terminal. 450: handle. 450(1) 

files from the HONEYWELL 6000./fget.demon: retrieve .fget(lC) 

send files to the HONEYWELL 6000. fsend: .fsend(lC) 

output to the HONEYWELL 6000./send phototypesetter .gcat(lC) 

procedures. 70boot: 11/70 bootstrap.70boot(8) 

operations. 750ops: VAX-11/750 console . 750ops(8) 

f77: Fortran 77 compiler.f77(l) 

operations. 780ops: VAX-11/780 console . 780ops(8) 

long integer and base-64/ a641,164a: convert between .a641(3C) 

abort: generate an lOT fault.abort(3C) 

abt: abort on-line diagnostics.abt(lM) 

program, abort: terminate Fortran.abort(3F) 

Fortran absolute value, abs, iabs, dabs, cabs, zabs:.abs(3F) 

value, abs: return integer absolute.abs(3C) 

adb: absolute debugger.adb(l) 

abs: return integer absolute value.abs(3C) 

dabs, cabs, zabs: Fortran absolute value, abs, iabs, .abs(3F) 

/floor, ceiling, remainder, absolute value functions.floor(3M) 

diagnostics, abt: abort on-line .abt(lM) 

LP requests, accept, reject: allow/prevent.accept(lM) 

of a file, touch: update access and modification times .touch(l) 

utime: set file access and modification times.utime(2) 

accessibility of a file, access: determine .access(2) 

commands, graphics: access graphical and numerical.graphics(lG) 

machine/ sputl, sgetl: access long numeric data in a.sputl(3X) 

sadp: disk access profiler.sadp(l) 

Idfcn: common object file access routines.ldfcn(4) 

copy file systems for optimal access time, dcopy: .dcopy(lM) 

/setutent, endutent, utmpname: access utmp file entry.getut(3C) 

access: determine accessibility of a file.access(2) 

enable or disable process accounting, acct: .acct(2) 

acctcon2: connect-time accounting, acctconl,.acctcon(lM) 

acctprcl, acctprc2: process accounting.acctprc(lM) 

turnacct: shell procedures for accounting./startup,.acctsh(lM) 

/accton, acctwtmp: overview of accounting and miscellaneous/.acct(lM) 

accounting and miscellaneous accounting commands./of.acct(lM) 

acct: per-process accounting file format.acct(4) 

search and print process accounting file(s). acctcom: .acctcom(l) 

acctmerg: merge or add total accounting files.acctmerg(lM) 
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mclock: return Fortran time accounting.mclock(3F) 

summary from per-process accounting records, /command.acctcms(lM) 

wtmpfix: manipulate connect accounting records, fwtmp, .fwtmp(lM) 

runacct: run daily accounting.runacct(lM) 

process accounting, acct: enable or disable .acct(2) 

file format, acct: per-process accounting.acct(4) 

per-process accounting/ acctcms: command summary from.acctcms(lM) 

process accounting file(s). acctcom: search and print.acctcom(l) 

connect-time accounting, acctconl, acctcon2:.acctcon(lM) 

accounting, acctconl, acctcon2: connect-time.acctcon(lM) 

acctwtmp: overview of/ acctdisk, acctdusg, accton,.acct(lM) 

overview of/acctdisk, acctdusg, accton, acctwtmp: .acct(lM) 

accounting files, acctmerg: merge or add total.acctmerg(lM) 

acctdisk, acctdusg, accton, acctwtmp: overview of/.acct(lM) 

accounting, acctprcl, acctprc2: process.acctprc(lM) 

acctprcl, acctprc2: process accounting.acctprc(lM) 

acctdisk, acctdusg, accton, acctwtmp: overview of/.acct(lM) 

sin, cos, tan, asin, acos, atan, atan2:/ .trig(3M) 

intrinsic function, acos, dacos: Fortran arccosine .acos(3F) 

killall: kill all active processes.killall(lM) 

sag: system activity graph.sag(lG) 

sal, sa2, sadc: system activity report package.sar(lM) 

sar: system activity reporter.sar(l) 

current sees file editing activity, sact: print.sact(l) 

report process data and system activity, /time a command;.timex(l) 

(AeU) interface, acu, dn: Automatic eall Unit.acu(7) 

acu, dn: Automatic eall Unit (AUU) interface.acu(7) 

acuset: connect AUUs and communication lines.acuset(lM) 

communication lines, acuset: connect AUUs and.acuset(lM) 

specification, nsc: NSe adapter interface.nsc(7) 

formatting/ mosd: the OSDD adapter macro package for.mosd(5) 

adb: absolute debugger.adb(l) 

acctmerg: merge or add total accounting files.acctmerg(lM) 

atb: attach to an Address Translation Buffer.atb(lM) 

sees files, admin: create and administer.admin(l) 

admin: create and administer SeeS files.admin(l) 

imaginary part of complex/ aimag, dimag: Fortran .aimag(3F) 

part intrinsic function, aint, dint: Fortran integer .aint(3F) 

alarm: set a process’s alarm clock.alarm(2) 

clock, alarm: set a process’s alarm .alarm(2) 

change data segment space allocation, brk, sbrk:.brk(2) 

realloc, calloc: main memory allocator, malloc, free, .malloc(3e) 

accept, reject: allow/prevent LP requests.accept(lM) 

natural logarithm/ log, alog, dlog, clog: Fortran.log(3F) 

logarithm intrinsic/log 10, aloglO, dloglO: Fortran common.logl0(3F) 

Fortran/max, maxO, amaxO, maxi, amaxl, dmaxl: .max(3F) 

max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran/.max(3F) 

Fortran/min, minO, aminO, mini, aminl, dminl:.min(3F) 

min, minO, aminO, mini, aminl, dminl: Fortran/.min(3F) 

remaindering intrinsic/ mod, amod, dmod: Fortran.mod(3F) 

rshift: Fortran bitwise/ and, or, xor, not, Ishift, .bool(3F) 

disk packs, format: format and/or check RP06 and RM05 .format(lM) 

sort: sort and/or merge files.sort(l) 

send, gath: gather files and/or submit RJE jobs.send(lC) 

Fortran nearest integer/ anint, dnint, nint, idnint:.round(3F) 

link editor output, a.out: common assembler and .a.out(4) 

mkboot: convert a.out file to boot image.mkboot(lM) 

link editor output, a.out: PDP-11 assembler and.a.out.pdp(4) 

introduction to commands and application programs, intro: .intro(l) 

maintenance commands and application programs./system .intro(lM) 

maintainer. ar: archive and library.ar.pdp(l) 

maintainer for portable/ ar: archive and library.ar(l) 

ar: archive file format.ar.pdp(4) 

format, ar: common archive file.ar(4) 

language.be: arbitrary-precision arithmetic.bc(l) 

acos, dacos: Fortran arccosine intrinsic function.acos(3F) 

maintainer. ar: archive and library.ar.pdp(l) 

for portable archives, ar: archive and library maintainer .ar(l) 

cpio: format of cpio archive.cpio(4) 

ar: common archive file format.ar(4) 

ar: archive file format.ar.pdp(4) 

header of a member of an archive file, /the archive.ldahread(3X) 
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common archive/arcv: convert archive files from PDP-11 to.arcv(l) 

convert: convert object and archive files to common/ .convert(l) 

files from PDP-11 to common archive format./archive.arcv(l) 

an archive/ Idahread: read the archive header of a member of.ldahread(3X) 

HP 2645A terminal tape file archiver, hpio: .hpio(l) 

tar: tape file archiver.tar(l) 

maintainer for portable archives./archive and library.ar(l) 

cpio: copy file archives in and out.cpio(l) 

asin, dasin: Fortran arcsine intrinsic function.asin(3F) 

atan2, datan2: Fortran arctangent intrinsic function.atan2(3F) 

atan, datan: Fortran arctangent intrinsic function.atan(3F) 

from PDP-11 to common archive/ arcv: convert archive files.arcv(l) 

imaginary part of complex argument, /dimag: Fortran.aimag(3F) 

return Fortran command-line argument, getarg: .getarg(3F) 

command, xargs: construct argument list(s) and execute.xargs(l) 

getopt: get option letter from argument vector.getopt(3C) 

expr: evaluate arguments as an expression.expr(l) 

echo: echo arguments.echo(l) 

be: arbitrary-precision arithmetic language.bc(l) 

number facts, arithmetic: provide drill in.arithmetic(6) 

expr: evaluate arguments as an expression.expr(l) 

as: assembler for PDP-11.as.pdp(l) 

as: common assembler.as(l) 

characters, asa: interpret ASA carriage control.asa(l) 

control characters, asa: interpret ASA carriage.asa(l) 

ascii: map of ASCII character set.ascii(5) 

set. ascii: map of ASCII character .ascii(5) 

long integer and base-64 ASCII string, /convert between.a641(3C) 

number, atof: convert ASCII string to floating-point.atof(3C) 

and/ ctime, localtime, gmtime, asetime, tzset: convert date.ctime(3C) 

trigonometric/ sin, cos, tan, asin, acos, atan, atan2: .trig(3M) 

intrinsic function, asin, dasin: Fortran arcsine.asin(3F) 

help: ask for help.help(l) 

output, a.out: common assembler and link editor .a.out(4) 

output, a.out: PDP-11 assembler and link editor .a.out.pdp(4) 

as: common assembler.as(l) 

as: assembler for PDP-11.as.pdp(l) 

KMCllB/kasb, kunb: assembler/un-assembler for the.kasb(l) 

assertion, assert: verify program.assert(3X) 

assert: verify program assertion.assert(3X) 

setbuf: assign buffering to a stream.setbuf(3S) 

kl: KL-11 orDL-11 asynchronous interface.kl(7) 

tn4: eight line asynchronous interface.tn4(7) 

tn74: two line asynchronous interface.tn74(7) 

/DZ-11, DZ-ll/KMC-llB, DH-11 asynchronous multiplexers.dz(7) 

sin, cos, tan, asin, acos, atan, atan2: trigonometric/.trig(3M) 

arctangent intrinsic/ atan, datan: Fortran.atan(3F) 

arctangent intrinsic/ atan2, datan2: Fortran.atan2(3F) 

cos, tan, asin, acos, atan, atan2: trigonometric/ sin, .trig(3M) 

Translation Buffer, atb: attach to an Address.atb(lM) 

floating-point number, atof: convert ASCII string to.atof(3C) 

integer, strtol, atol, atoi: convert string to.strtol(3C) 

integer, strtol, atol, atoi: convert string to.strtol(3C) 

link. x25alnk, x25ilnk: attach or install a BX.25 .x25alnk(3C) 

Translation Buffer, atb: attach to an Address .atb(lM) 

interface, acu, dn: Automatic Call Unit (ACU) .acu(7) 

wait: await completion of process.wait(l) 

processing language, awk: pattern scanning and.awk(l) 

ungetc: push character back into input stream.ungetc(3S) 

back: the game of backgammon.back(6) 

back: the game of backgammon.back(6) 

daily/weekly UNIX file system backup, filesave, tapesave:.filesave(lM) 

fine: fast incremental backup.finc(lM) 

free: recover files from a backup tape.frec(lM) 

banner: make posters.banner(l) 

between long integer and base-64 ASCII string, /convert.a641(3C) 

portions of path names, basename, dimame: deliver .basename(l) 

arithmetic language, be: arbitrary-precision.bc(l) 

system initialization/bre, bcheckrc, rc, powerfail:.brc(lM) 

bcopy: interactive block copy.bcopy(lM) 

bdiff: big diff.bdiff(l) 

cb: C program beautifier.cb(l) 
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jO, jl, jn, yO, yl, yn: Bessel functions.bessel(3M) 

bfs: big file scanner.bfs(l) 

fread, fwrite: binary input/output.fread(3S) 

bsearch: binary search.bsearch(3C) 

tdelete, twalk: manage binary search trees, tsearch, .tsearch(3C) 

remove symbols and relocation bits, strip: .strip.pdp(l) 

/not, Ishift, rshift: Fortran bitwise boolean functions.bool(3F) 

bj: the game of blackjack.bj(6) 

bj: the game of blackjack.bj(6) 

bcopy: interactive block copy.bcopy(lM) 

sum: print checksum and block count of a file.sum(l) 

sync: update the super block.sync(l) 

df: report number of free disk blocks.df(lM) 

rshift: Fortran bitwise boolean functions./Ishift,.bool(3F) 

mkboot: convert a.out file to boot image.mkboot(lM) 

unixboot: UNIX startup and boot procedures.unixboot(8) 

romboot: special ROM bootstrap loaders.romboot(8) 

3B20boot: 3B20S bootstrap procedures.3B20boot(8) 

70boot: 11/70 bootstrap procedures.70boot(8) 

tapeboot: magnetic tape bootstrap program.tapeboot(8) 

diskboot: disk bootstrap programs.diskboot(8) 

system initialization shell/ brc, bcheckrc, rc, powerfail: .brc(lM) 

space allocation, brk, sbrk: change data segment.brk(2) 

modest-sized programs, bs: a compiler/interpreter for.bs(l) 

bsearch: binary search.bsearch(3C) 

to an Address Translation Buffer, atb: attach.atb(lM) 

read the EAI Input Parameter Buffer, ipb:.ipb(lM) 

stdio: standard buffered input/output package.stdio(3S) 

setbuf: assign buffering to a stream.setbuf(3S) 

mknod: build special file.mknod(lM) 

dmc: communications link with built-in DDCMP protocol.dmc(7) 

x25ilnk: attach or install a BX.25 link. x25alnk,.x25alnk(3C) 

x25clnk: change over a BX.25 link.x25clnk(3C) 

x25dlnk: halt or detach a BX.25 link. x25hlnk,.x25hlnk(3C) 

/remove, or get status for a BX.25 minor device or link.x25pvc(lM) 

x25: BX.25 network interface.x25(7) 

swab: swap bytes.swab(3C) 

cc, pcc: C compiler.cc(l) 

programs, see: C compiler for stand-alone.scc(l) 

cflow: generate C flow graph.cflow(l) 

epp: the C language preprocessor.cpp(l) 

cb: C program beautifier.cb(l) 

lint: a C program checker.lint(l) 

cxref: generate C program cross reference.cxref(l) 

object file, list: produce C source listing from 3B20S.list(l) 

value, abs, iabs, dabs, cabs, zabs: Fortran absolute .abs(3F) 

cal: print calendar.cal(l) 

dc: desk calculator.dc(l) 

cal: print calendar.cal(l) 

calendar: reminder service.calendar( 1) 

cu: call another UNIX system.cu(lC) 

data returned by stat system call, stat:.stat(5) 

acu, dn: Automatic Call Unit (ACU) interface.acu(7) 

malloc, free, realloc, calloc: main memory allocator.malloc(3C) 

intro: introduction to system calls and error numbers.intro(2) 

link and unlink system calls, link, unlink: exercise .link(lM) 

sys3b: 3B20S specific system calls.sys3b(2) 

to an LP line printer. Ip, cancel: send/cancel requests .lp(l) 

pnch: file format for card images.pnch(4) 

asa: interpret ASA carriage control characters.asa(l) 

files, cat: concatenate and print .cat(l) 

interface, cat: phototypesetter.cat(7) 

cb: C program beautifier.cb(l) 

cc, pcc: C compiler.cc(l) 

function, cos, dcos, ccos: Fortran cosine intrinsic.cos(3F) 

cd: change working directory.cd(l) 

commentary of an sees delta, ede: change the delta.cdc(l) 

ceiling, remainder,/floor, ceil, fmod, fabs: floor, .floor(3M) 

/ceil, fmod, fabs: floor, ceiling, remainder, absolute/.floor(3M) 

intrinsic/ exp, dexp, cexp: Fortran exponential.exp(3F) 

cflow: generate e flow graph.cflow(l) 

delta: make a delta (change) to an SeeS file.delta(l) 
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Permuted Index 


pipe: create an interprocess channel.pipe(2) 

/dble, cmplx, dcmplx, ichar, char: explicit Fortran type/.ftype(3F) 

stream, ungetc: push character back into input .ungetc(3S) 

and neqn. eqnchar: special character definitions for eqn .eqnchar(5) 

user, cuserid: get character login name of the .cuserid(3S) 

/getchar, fgetc, getw: get character or word from stream.getc(3S) 

/putchar, fputc, putw: put character or word on a stream.putc(3S) 

ascii: map of ASCII character set.ascii(5) 

interpret ASA carriage control characters, asa: .asa(l) 

tolower, toascii: translate characters, / toupper,.conv(3C) 

iscntrl, isascii: classify characters, /isprint, isgraph, .ctype(3C) 

tr: translate characters.tr(l) 

lastlogin, monacct, nulladm,/ chargefee, ckpacct, dodisk,.acctsh(lM) 

directory, chdir: change working .chdir(2) 

/dfsck: file system consistency check and interactive repair.fsck(lM) 

packs, format: format and/or check RP06 and RM05 disk.format(lM) 

checking procedure, checkall: faster file system.checkall(lM) 

constant-width text for/ cw, checkcw: prepare .cw(l) 

text for nroff or/eqn, neqn, checkeq: format mathematical .eqn(l) 

lint: a C program checker.lint(l) 

grpck: password/group file checkers, pwck,.pwck(lM) 

checkall: faster file system checking procedure.checkall(lM) 

copy file systems with label checking, volcopy, labelit:.volcopy(lM) 

systems processed by fsck. checklist: list of file .checklist(4) 

formatted with the/mm, osdd, checkmm: print/check documents.mm(l) 

file, sum: print checksum and block count of a.sum(l) 

chess: the game of chess.chess(6) 

chess: the game of chess.chess(6) 

chown, chgrp: change owner or group.chown(l) 

times: get process and child process times.times(2) 

terminate, wait: wait for child process to stop or.wait(2) 

spooler map file, chmap: change the diagnostic.chmap(lM) 

chmod: change mode.chmod(l) 

chmod: change mode of file.chmod(2) 

of a file, chown: change owner and group .chown(2) 

group, chown, chgrp: change owner or.chown(l) 

chroot: change root directory.chroot(2) 

for a command, chroot: change root directory.chroot(lM) 

monacct, nulladm,/chargefee, ckpacct, dodisk, lastlogin,.acctsh(lM) 

isgraph, iscntrl, isascii: classify characters./isprint, .ctype(3C) 

uuclean: uucp spool directory clean-up.uuclean(lM) 

clri: clear i-node.clri(lM) 

status/ ferror, feof, clearerr, fileno: stream .ferror(3S) 

alarm: set a process’s alarm clock.alarm(2) 

cron: clock daemon.cron(lM) 

clock: report CPU time used.clock(3C) 

logarithm/ log, alog, dlog, clog: Fortran natural .log(3F) 

Idclose, Idaclose: close a common object file.ldclose(3X) 

close: close a file descriptor.close(2) 

descriptor, close: close a file.close(2) 

fclose, fflush: close or flush a stream.fclose(3S) 

clri: clear i-node.clri(lM) 

System Status/ssr, setssr, clrssr: print or modify the.ssr(lM) 

cmp: compare two files.cmp(l) 

/real, float, sngl, dble, cmplx, dcmplx, ichar, char:/.ftype(3F) 

line-feeds, col: filter reverse.col(l) 

comb: combine SCCS deltas.comb(l) 

comb: combine SCCS deltas.comb(l) 

common to two sorted files, comm: select or reject lines .comm(l) 

nice: run a command at low priority.nice(l) 

change root directory for a command, chroot:.chroot(lM) 

env: set environment for command execution.env(l) 

uux: Unix to Unix command execution.uux(lC) 

system: issue a shell command from Fortran.system(3F) 

quits, nohup: run a command immune to hangups and.nohup(l) 

net: execute a command on the PCL network.net(lC) 

getopt: parse command options.getopt(l) 

/shell, the standard/restricted command programming language.sh(l) 

and system/timex: time a command; report process data .timex(l) 

per-process/acctcms: command summary from .acctcms(lM) 

system: issue a shell command.system(3S) 

test: condition evaluation command.test(l) 
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Permuted Index 


time: time a 
argument list(s) and execute 
getarg: return Fortran 
and miscellaneous accounting 
intro: introduction to 
/to system maintenance 
access graphical and numerical 
install: install 
how to remake the system and 
network useful with graphical 
cdc: change the delta 
ar: 

/archive files from PDP-11 to 
editor output, a.out: 

as: 

object and archive files to 
loglO, aloglO, dloglO: Fortran 
routines. Idfcn: 
Idopen, Idaopen: open a 
/line number entries of a 
Idclose, Idaclose: close a 
read the file header of a 
entries of a section of a 
the optional file header of a 
/entries of a section of a 
/section header of a 
an indexed/named section of a 
of a symbol table entry of a 
symbol table entry of a 
seek to the symbol table of a 
line number entries in a 
nm: print name list of 
relocation information for a 
scnhdr: section header for a 
line number information from a 
table format, syms: 
filehdr: file header for 
Id: link editor for 
size: print section sizes of 
comm: select or reject lines 
/VPM drivers and programmable 
ipcs: report inter-process 
acuset: connect ACUs and 
stdipc: standard interprocess 
pci: parallel 
built-in DDCMP protocol, dmc: 

diff: differential file 
cmp: 

sees file, scesdiff: 
diff3: 3-way differential file 
diremp: directory 
expression, regemp, regex: 
regexp: regular expression 
regemp: regular expression 
cc, pcc: e 
f77: Fortran 77 
programs, see: e 
protocol machine, vpmc: 
protocol machine, vpmc: 
yacc: yet another 
modest-sized programs, bs: a 
erf, erfc: error function and 
wait: await 
Fortran imaginary part of 
conjg, dconjg: Fortran 
cprs: 

pack, peat, unpack: 
table entry of a/ Idtbindex: 

cat: 

synchronous printer, scat: 

test: 

system. 


command.time(l) 

command, xargs: construct .xargs(l) 

command-line argument.getarg(3F) 

commands./of accounting.acct(lM) 

commands and application/ .intro(l) 

commands and application/ .intro(lM) 

commands, graphics:.graphics(lG) 

commands.install(lM) 

commands, mk:.mk(8) 

commands, stat: statistical.stat(lG) 

commentary of an sees delta.cdc(l) 

common archive file format.ar(4) 

common archive format.arcv(l) 

common assembler and link.a.out(4) 

common assembler.as(l) 

common formats, /convert.convert(l) 

common logarithm intrinsic/.loglO(3F) 

common object file access.ldfcn(4) 

common object file for/.ldopen(3X) 

common object file function.ldlread(3X) 

common object file.ldclose(3X) 

common object file. Idfhread: .ldfhread(3X) 

common object file, /number.ldlseek(3X) 

common object file, /seek to.ldohseek(3X) 

common object file.ldrseek(3X) 

common object file.ldshread(3X) 

common object file, /seek to.ldsseek(3X) 

common object file, /the index.ldtbindex(3X) 

common object file, /indexed.ldtbread(3X) 

common object file. Idtbseek: .ldtbseek(3X) 

common object file, linenum: .linenum(4) 

common obj ect file.nm( 1) 

common object file, reloc:.reloc(4) 

common object file.scnhdr(4) 

common object file./and .strip(l) 

common object file symbol .syms(4) 

common object files.filehdr(4) 

common object files.ld(l) 

common object files.size(l) 

common to two sorted files.comm(l) 

communication devices.vpmset(lM) 

communication facilities/ .ipcs(l) 

communication lines.acuset(lM) 

communication package.stdipc(3C) 

communications link interface.pcl(7) 

communications link with.dmc(7) 

comparator.diff(l) 

compare two files.cmp(l) 

compare two versions of an .sccsdiff(l) 

comparison.diff3(l) 

comparison.dircmp(l) 

compile and execute regular.regcmp(3X) 

compile and match routines.regexp(5) 

compile.regcmp(l) 

compiler.cc(l) 

compiler.f77(l) 

compiler for stand-alone.scc(l) 

compiler for the virtual.vpmc.dec(lM) 

compiler for the virtual.vpmc.u3b(lM) 

compiler-compiler.yacc(l) 

compiler/interpreter for.bs(l) 

complementary error function.erf(3M) 

completion of process.wait(l) 

complex argument, /dimag: .aimag(3F) 

complex conjugate intrinsic/.conjg(3F) 

compress an IS25 object file.cprs(l) 

compress and expand files.pack(l) 

compute the index of a symbol.ldtbindex(3X) 

concatenate and print files.cat(l) 

concatenate and print files on.scat(l) 

condition evaluation command.test(l) 

config: configure a UNIX.config.3b(lM) 
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Permuted Index 


system, config: configure a UNIX.config.dc(lM) 

program, vcf: VAX-11/780 configuration verification .vcf(lM) 

config: configure a UNIX system.config.3b(lM) 

config: configure a UNIX system.config.dc(lM) 

system. Ipadmin: configure the LP spooling.Ipadmin(lM) 

conjugate intrinsic function, conjg, dconjg: Fortran complex.conjg(3F) 

conjg, dconjg: Fortran complex conjugate intrinsic function.conjg(3F) 

fwtmp, wtmpfix: manipulate connect accounting records.fwtmp(lM) 

lines, acuset: connect ACUs and communication .acuset(lM) 

an out-going terminal line connection, dial: establish.dial(3C) 

vpmset, vpmstart: connect/load VPM drivers and/.vpmset(lM) 

acctconl, acctcon2: connect-time accounting.acctcon(lM) 

fsck, dfsck: file system consistency check and/.fsck(lM) 

vlx: VAX-11/780 LSI console floppy interface.vlx(lM) 

3B20ops: 3B20S console operations.3B20ops(8) 

750ops: VAX-11/750 console operations. 750ops(8) 

780ops: VAX-11/780 console operations. 780ops(8) 

report and interactive status console, rjestat: RJE status.rjestat(lC) 

tn83: console/printer interface.tn83(7) 

cw, checkcw: prepare constant-width text for troff.cw(l) 

mkfs: construct a file system.mkfs(lM) 

execute command, xargs: construct argument list(s) and.xargs(l) 

nroff/troff, tbl, and eqn constructs, deroff: remove.deroff(l) 

Is: list contents of directories.ls(l) 

toe: graphical table of contents routines.toc(lG) 

esplit: context split.csplit(l) 

asa: interpret ASA carriage control characters.asa(l) 

ioctl: control device.ioctl(2) 

fcntl: file control.fcntl(2) 

perform 3270 emulation control functions, emulcntrl:.emulcntrl(lM) 

init, telinit: process control initialization.init(lM) 

dmk: DM11-BA modem control multiplexor.dmk(7) 

nc: network control.nc(7) 

msgctl: message control operations.msgctl(2) 

semctl: semaphore control operations.semctl(2) 

shmctl: shared memory control operations.shmctl(2) 

fcntl: file control options.fcntl(5) 

St: synchronous terminal control.st(lM) 

nsemon: operationally control the NSC local network.nscmon(lM) 

uucp status inquiry and job control, uustat: .uustat(lC) 

vc: version control.vc(l) 

medium speed line printer controller. tn85:.tn85(7) 

emulstat: get 3270 emulation controller/terminal status.emulstat(lM) 

interface, tty: controlling terminal .tty(7) 

terminals, term: conventional names for.term(5) 

char: explicit Fortran type conversion, /dcmplx, ichar, .ftype(3F) 

units: conversion program.units(l) 

dd: convert and copy a file.dd(l) 

image, mkboot: convert a.out file to boot.mkboot(lM) 

PDF-11 to common/arev: convert archive files from.arcv(l) 

floating-point number, atof: convert ASCII string to.atof(3C) 

integers and/ 13tol, ltol3: convert between 3-byte.13tol(3C) 

and base-64 ASCII/ a641,164a: convert between long integer.a641(3C) 

archive files to common/ convert: convert object and .convert(l) 

/gmtime, asetime, tzset: convert date and time to/ .ctime(3C) 

and VAX-11/780 systems, fsev: convert files between PDP-11 .fscv(lM) 

to string, ecvt, fevt, gevt: convert floating-point number .ecvt(3C) 

scanf, fscanf, sscanf: convert formatted input.scanf(3S) 

files to common/convert: convert object and archive.convert(l) 

strtol, atol, atoi: convert string to integer.strtol(3C) 

dd: convert and copy a file.dd(l) 

bcopy: interactive block copy.bcopy(lM) 

cpio: copy file archives in and out.cpio(l) 

access time, dcopy: copy file systems for optimal.dcopy(lM) 

checking, volcopy, labelit: copy file systems with label .volcopy(lM) 

cp, In, mv: copy, link or move files.cp(l) 

uulog, uuname: Unix to Unix copy, uucp,.uucp(lC) 

public UNIX-to-UNIX file copy, uuto, uupick: .uuto(lC) 

file, core: format of core image.core(4) 

core: format of core image file.core(4) 

mem, kmem: core memory.mem(7) 

cosine intrinsic function, cos, dcos, ccos: Fortran.cos(3F) 
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atan2: trigonometric/ sin, cos, tan, asin, acos, atan,.trig(3M) 

hyperbolic cosine intrinsic/ cosh, dcosh: Fortran .cosh(3F) 

functions, sinh, cosh, tanh: hyperbolic.sinh(3M) 

cos, dcos, ccos: Fortran cosine intrinsic function.cos(3F) 

/dcosh: Fortran hyperbolic cosine intrinsic function.cosh(3F) 

sum: print checksum and block count of a file.sum(l) 

wc: word count.wc(l) 

files, cp, In, mv: copy, link or move .cp(l) 

cpio: format of cpio archive.cpio(4) 

and out. cpio: copy file archives in.cpio(l) 

cpio: format of cpio archive.cpio(4) 

preprocessor, cpp: the C language .cpp(l) 

file, cprs: compress an IS25 object .cprs(l) 

clock: report CPU time used.clock(3C) 

craps: the game of craps.craps(6) 

craps: the game of craps.craps(6) 

crash: examine system images.crash(lM) 

system crashes, crash: what to do when the.crash.dec(8) 

system crashes, crash: what to do when the.crash.u3b(8) 

what to do when the system crashes, crash: .crash.dec(8) 

what to do when the system crashes, crash: .crash.u3b(8) 

rewrite an existing one. creat: create a new file or .creat(2) 

file, tmpnam, tempnam: create a name for a temporary .tmpnam(3S) 

an existing one. creat: create a new file or rewrite.creat(2) 

fork: create a new process.fork(2) 

tmpfile: create a temporary file.tmpfile(3S) 

channel, pipe: create an interprocess.pipe(2) 

files, admin: create and administer SCCS .admin(l) 

umask: set and get file creation mask.umask(2) 

cron: clock daemon.cron(lM) 

cxref: generate C program cross reference.cxref(l) 

crypt: encode/decode.crypt(l) 

generate DES encryption, crypt, setkey, encrypt:.crypt(3C) 

function, sin, dsin, csin: Fortran sine intrinsic.sin(3F) 

csplit: context split.csplit(l) 

intrinsic/ sqrt, dsqrt, csqrt: Fortran square root .sqrt(3F) 

terminal, ct: spawn getty to a remote.ct(lC) 

for terminal, ctermid: generate file name.ctermid(3S) 

asctime, tzset: convert date/ ctime, localtime, gmtime, .ctime(3C) 

cu: call another UNIX system.cu(lC) 

ttt, cubic: tic-tac-toe.ttt(6) 

activity, sact: print current SCCS file editing .sact(l) 

uname: print name of current UNIX system.uname(l) 

uname: get name of current UNIX system.uname(2) 

slot in the utmp file of the current user, /find the.ttyslot(3C) 

getcwd: get path-name of current working directory.getcwd(3C) 

spline: interpolate smooth curve.spline(lG) 

name of the user, cuserid: get character login.cuserid(3S) 

of each line of a file, cut: cut out selected fields.cut(l) 

each line of a file, cut: cut out selected fields of.cut(l) 

constant-width text for/ cw, checkcw: prepare.cw(l) 

cross reference, cxref: generate C program.cxref(l) 

absolute value, abs, iabs, dabs, cabs, zabs: Fortran.abs(3F) 

intrinsic function, acos, dacos: Fortran arccosine.acos(3F) 

cron: clock daemon.cron(lM) 

sending daemon, line printer daemon, dpd, Ipd: HONEYWELL .dpd(lC) 

errdemon: error-logging daemon.errdemon(lM) 

terminate the error-logging daemon, errstop: .errstop(lM) 

dpd, Ipd: HONEYWELL sending daemon, line printer daemon.dpd(lC) 

runacct: run daily accounting.runacct(lM) 

backup, filesave, tapesave: daily/weekly UNIX file system.filesave(lM) 

/handle special functions of DASI 300 and 300s terminals. 300(1) 

special functions of the DASI 450 terminal./handle. 450(1) 

intrinsic function, asin, dasin: Fortran arcsine.asin(3F) 

/time a command; report process data and system activity.timex(l) 

/sgetl: access long numeric data in a machine independent/.sputl(3X) 

plock: lock process, text, or data in memory.plock(2) 

prof: display profile data.prof(l) 

call, stat: data returned by stat system .stat(5) 

brk, sbrk: change data segment space allocation.brk(2) 

types: primitive system data types.types(5) 

join: relational database operator.join(l) 












































































Permuted Index 


intrinsic function, atan, datan: Fortran arctangent .atan(3F) 

intrinsic function. atan2, datan2: Fortran arctangent.atan2(3F) 

/asctime, tzset: convert date and time to string.ctime(3C) 

date: print and set the date.date(l) 

date: print and set the date.date(l) 

/idint, real, float, sngl, dble, cmplx, dcmplx, ichar,/.ftype(3F) 

dc: desk calculator.dc(l) 

/float, sngl, dble, cmplx, dcmplx, ichar, char: explicit/.ftype(3F) 

conjugate intrinsic/ conjg, dconjg: Fortran complex .conjg(3F) 

optimal access time, dcopy: copy file systems for.dcopy(lM) 

intrinsic function, cos, dcos, ccos: Fortran cosine.cos(3F) 

cosine intrinsic/ cosh, dcosh: Fortran hyperbolic.cosh(3F) 

dd: convert and copy a file.dd(l) 

/link with built-in DDCMP protocol.dmc(7) 

adb: absolute debugger.adb(l) 

fsdb: file system debugger.fsdb(lM) 

sdb: symbolic debugger.sdb(l) 

sysdef: system definition.sysdef(lM) 

eqnchar: special character definitions for eqn and neqn.eqnchar(5) 

names, basename, dirname: deliver portions of path.basename(l) 

file, tail: deliver the last part of a.tail(l) 

delta commentary of an sees delta, ede: change the.cdc(l) 

file, delta: make a delta (change) to an SeeS.delta(l) 

delta, ede: change the delta commentary of an SeeS .cdc(l) 

rmdel: remove a delta from an SeeS file.rmdel(l) 

to an sees file, delta: make a delta (change) .delta(l) 

comb: combine SeeS deltas.comb(l) 

mesg: permit or deny messages.mesg(l) 

tbl, and eqn constructs, deroff: remove nroff/troff,.deroff(l) 

setkey, encrypt: generate DES encryption, crypt,.crypt(3e) 

system: format of 3B20S system description file.system(4) 

close: close a file descriptor.close(2) 

dup: duplicate an open file descriptor.dup(2) 

dc: desk calculator.dc(l) 

x25hlnk, x25dlnk: halt or detach a BX.25 link.x25hlnk(3C) 

file, access: determine accessibility of a .access(2) 

file: determine file type.file(l) 

master: master device information table.master.dec(4) 

master: master device information table.master.u3b(4) 

UN53/TN82 synchronous device interface. un53: un53(7) 

ioctl: control device.ioctl(2) 

off or/don, doff, disp: device logically on, logically.don(lM) 

devnm: device name.devnm(lM) 

get status for a BX.25 minor device or link./remove, or.x25pvc(lM) 

/tekset, td: graphical device routines and filters.gdev(lG) 

and programmable communication devices. /VPM drivers .vpmset(lM) 

devnm: device name.devnm(lM) 

exponential intrinsic/ exp, dexp, cexp: Fortran.exp(3F) 

blocks, df: report number of free disk.df(lM) 

check and interactive/fsck, dfsck: file system consistency .fsck(lM) 

diagnostics, dgn: initiate on-line .dgn(lM) 

interface, dgn: on-line diagnostic .dgn(7) 

DH-11 asynchronous/dz,dzb, dh: DZ-11, DZ-ll/KMC-llB, .dz(7) 

dzb, dh: DZ-11, DZ-11/KMC-l IB, DH-11 asynchronous/ dz,.dz(7) 

dgn: on-line diagnostic interface.dgn(7) 

msi: memory system diagnostic interface.msi(lM) 

find status of pending on-line diagnostic requests, sta:.sta(lM) 

chmap: change the diagnostic spooler map file.chmap(lM) 

abt: abort on-line diagnostics.abt(lM) 

dgn: initiate on-line diagnostics.dgn(lM) 

and find status of on-line diagnostics./start, stop.dstart(lM) 

from service before on-line diagnostics, rmv: remove unit .rmv(lM) 

unit to service after on-line diagnostics, rst: restore.rst(lM) 

terminal line connection, dial: establish an out-going.dial(3C) 

ratfor: rational Fortran dialect.ratfor(l) 

bdiffibig diff.bdiff(l) 

comparator, diff: differential file .diff(l) 

comparison. diff3: 3-way differential file .diff3(l) 

sdiff: side-by-side difference program.sdiff(l) 

diffmk: mark differences between files.diffmk(l) 

diff: differential file comparator.diff(l) 

diff3: 3-way differential file comparison.diff3(l) 
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Permuted Index 


between files, diffmk: mark differences .diffmk(l) 

of complex argument, aimag, dimag: Fortran imaginary part .aimag(3F) 

intrinsic function, aint, dint: Fortran integer part.aint(3F) 

dir: format of directories.dir(4) 

dircmp: directory comparison.dircmp(l) 

dir: format of directories.dir(4) 

Is: list contents of directories.ls(l) 

rm, rmdir: remove files or directories.rm(l) 

cd: change working directory.cd(l) 

chdir: change working directory.chdir(2) 

chroot: change root directory.chroot(2) 

uuclean: uucp spool directory clean-up.uuclean(lM) 

dircmp: directory comparison.dircmp(l) 

unlink: remove directory entry.unlink(2) 

chroot: change root directory for a command.chroot(lM) 

path-name of current working directory, getcwd: get .getcwd(3C) 

mkdinmakea directory.mkdir(l) 

mvdir:movea directory.mvdir(lM) 

pwd: working directory name.pwd(l) 

ordinary file, mknod: make a directory, or a special or.mknod(2) 

path names, basename, dirname: deliver portions of .basename(l) 

dis: 3B20S disassembler.dis(l) 

printers, enable, disable: enable/disable LP.enable(l) 

acct: enable or disable process accounting.acct(2) 

dis: 3B20S disassembler.dis(l) 

type, modes, speed, and line discipline./set terminal.getty(lM) 

sadp: disk access profiler.sadp(l) 

df: report number of free disk blocks.df(lM) 

diskboot: disk bootstrap programs.diskboot(8) 

dsk: 3B20S moving-head disk.dsk(7) 

RHl 1/RJS03-RJS04 fixed-head disk file, hs: .hs(7) 

rf: RFll/RSll fixed-head disk file.rf(7) 

Idtape: load disk from tape procedures.ldtape(8) 

hm: RM05 moving-head disk.hm(7) 

moving-head disk. /RP04/RP05/RP06 .hp(7) 

mill: MLll solid-state disk.mlll(7) 

dskvfy: format and verify disk packs, dskfmt, .dskfmt(lM) 

and/or check RP06 and RM05 disk packs, format: format.format(lM) 

rk:RK-ll/RK03orRK05 disk.rk(7) 

rl: RL-ll/RLOl disk.rl(7) 

rmSO: RM80 moving-head disk.rm80(7) 

medium moving-head disk. /RP07 non-removable .rp07(7) 

rp: RP-11/RP03 moving-head disk.rp(7) 

du: summarize disk usage.du(l) 

programs, diskboot: disk bootstrap.diskboot(8) 

general driver for moving-head disks, gd: .gd(7) 

mount, umount: mount and dismount file system.mount(lM) 

logically off or/don, doff, disp: device logically on, .don(lM) 

prof: display profile data.prof(l) 

logically on, logically off or display status./disp: device .don(lM) 

hypot: Euclidean distance function.hypot(3M) 

/lcong48: generate uniformly distributed pseudo-random/ .drand48(3C) 

kl:KL-llor DL-11 asynchronous interface.kl(7) 

logarithm/ log, alog, dlog, clog: Fortran natural.log(3F) 

logarithm/logic, aloglO, dloglO: Fortran common .loglO(3F) 

multiplexor, dmk: DM11-BA modem control.dmk(7) 

max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran maximum-value/.max(3F) 

built-in DDCMP protocol, dmc: communications link with.dmc(7) 

min, minO, aminO, mini, aminl, dminl: Fortran minimum-value/ .min(3F) 

multiplexor, dmk: DM11-BA modem control .dmk(7) 

intrinsic/ mod, amod, dmod: Fortran remaindering.mod(3F) 

interface, acu, dn: Automatic Call Unit (ACU).acu(7) 

nearest integer/ anint, dnint, nint, idnint: Fortran.round(3F) 

mm, osdd, checkmm: print/check documents formatted with the/.mm(l) 

macro package for formatting documents, mm: the MM.mm(5) 

macro package for formatting documents./the OSDD adapter.mosd(5) 

slides, mmt, mvt: typeset documents, view graphs, and.mmt(l) 

nulladm,/chargefee, ckpacct, dodisk, lastlogin, monacct,.acctsh(lM) 

on, logically off or/don, doff, disp: device logically.don(lM) 

whodo: who is doing what.whodo(lM) 

logically on, logically off/ don, doff, disp: device .don(lM) 

daemon, line printer daemon, dpd, Ipd: HONEYWELL sending.dpd(lC) 
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Permuted Index 


dpr: off-line print.dpr(lC) 

reversi: a game of dramatic reversals.reversi(6) 

nrand48, mrand48, jrand48,/ drand48, erand48, lrand48,.drand48(3C) 

graph: draw a graph.graph(lG) 

arithmetic: provide drill in number facts.arithmetic(6) 

gd: general driver for moving-head disks.gd(7) 

gt: general driver for tape drives.gt(7) 

trace: event-tracing driver.trace(7) 

/vpmstart: connect/load VPM drivers and programmable/.vpmset(lM) 

gt: general driver for tape drives.gt(7) 

transfer-of-sign/ sign, isign, dsign: Fortran.sign(3F) 

intrinsic function, sin, dsin, csin: Fortran sine .sin(3F) 

intrinsic function, sinh, dsinh: Fortran hyperbolic sine .sinh(3F) 

dsk: 3B20S moving-head disk.dsk(7) 

verify disk packs, dskfmt, dskvfy: format and.dskfmt(lM) 

packs, dskfmt, dskvfy: format and verify disk .dskfmt(lM) 

root intrinsic/ sqrt, dsqrt, csqrt: Fortran square.sqrt(3F) 

stop and find status of/ dstart, dstop, dstat: start,.dstart(lM) 

status of/dstart, dstop, dstat: start, stop and find.dstart(lM) 

find status of/dstart, dstop, dstat: start, stop and.dstart(lM) 

intrinsic function, tan, dtan: Fortran tangent.tan(3F) 

tangent intrinsic/ tanh, dtanh: Fortran hyperbolic .tanh(3F) 

interface, du: DU-11 synchronous line.du(7) 

du: summarize disk usage.du(l) 

interface, du: DU-11 synchronous line.du(7) 

an object file, dump: dump selected parts of.dump(l) 

extract error records from dump, errdead: .errdead(lM) 

od: octal dump.od(l) 

object file, dump: dump selected parts of an .dump(l) 

descriptor, dup: duplicate an open file.dup(2) 

descriptor, dup: duplicate an open file.dup(2) 

DZ-11/KMC-11B,DH-11/ dz, dzb, dh: DZ-11,.dz(7) 

asynchronous/dz, dzb, dh: DZ-11, DZ-ll/KMC-llB, DH-11.dz(7) 

dz, dzb, dh: DZ-11, DZ-ll/KMC-llB, DH-11/.dz(7) 

DH-11 asynchronous/dz, dzb, dh: DZ-11, DZ-11/KMC-l IB, .dz(7) 

interface, eai: 3B20S emergency action.eai(8) 

ipb: read the EAI Input Parameter Buffer.ipb(lM) 

echo: echo arguments.echo(l) 

echo: echo arguments.echo(l) 

floating-point number to/ ecvt, fcvt, gcvt: convert.ecvt(3C) 

ed, red: text editor.ed(l) 

program, end, etext, edata: last locations in .end(3C) 

sact: print current sees file editing activity.sact(l) 

ed, red: text editor.ed(l) 

files. Id: link editor for common object .ld(l) 

se: screen editor for video terminals.se(l) 

ged: graphical editor.ged(lG) 

Id: link editor.Id.pdp(l) 

common assembler and link editor output, a.out: .a.out(4) 

PDP-11 assembler and link editor output, a.out: .a.out.pdp(4) 

sed: stream editor.sed(l) 

/user, real group, and effective group IDs.getuid(2) 

and/ /getegid: get real user, effective user, real group, .getuid(2) 

Language, efl: Extended Fortran.efl(l) 

fsplit: split f77, ratfor, or efl files.fsplit(l) 

for a pattern, grep, egrep, fgrep: search a file .grep(l) 

interface. tn4: eight line asynchronous.tn4(7) 

eai: 3B20S emergency action interface.eai(8) 

emulcntrl: perform 3270 emulation control functions.emulcntrl(lM) 

status, emulstat: get 3270 emulation controller/terminal.emulstat(lM) 

emulio: 3270 emulation interface.emulio(7) 

emulload: load and start 3270 emulation script.emulload(lM) 

emulation control functions, emulcntrl: perform 3270 .emulcntrl(lM) 

interface, emulio: 3270 emulation.emulio(7) 

emulation script, emulload: load and start 3270 .emulload(lM) 

controller/terminal status, emulstat: get 3270 emulation.emulstat(lM) 

enable/disable LP printers, enable, disable: .enable(l) 

accounting, acet: enable or disable process .acct(2) 

enable, disable: enable/disable LP printers.enable(l) 

crypt: encode/decode.crypt(l) 

encryption, crypt, setkey, encrypt: generate DES .crypt(3C) 

setkey, encrypt: generate DES encryption, crypt, .crypt(3C) 
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Permuted Index 


makekey: generate encryption key.makekey(l) 

locations in program, end, etext, edata: last.end(3C) 

/getgrgid, getgmam, setgrent, endgrent: get group file/.getgrent(3C) 

/getpwuid, getpwnam, setpwent, endpwent: get password file/.getpwent(3C) 

utmp/ /pututline, setutent, endutent, utmpname: access .getut(3C) 

nlist: get entries from name list.nlist(3C) 

file, linenum: line number entries in a common object.linenum(4) 

man, manprog: print entries in this manual.man(l) 

man: macros for formatting entries in this manual.man(5) 

file/ /manipulate line number entries of a common object.ldlread(3X) 

common/ /seek to line number entries of a section of a.ldlseek(3X) 

/Idnrseek: seek to relocation entries of a section of a/.ldrseek(3X) 

utmp, wtmp: utmp and wtmp entry formats.utmp(4) 

endgrent: get group file entry, /getgrnam, setgrent,.getgrent(3C) 

endpwent: get password file entry, /getpwnam, setpwent,.getpwent(3C) 

utmpname: access utmp file entry, /setutent, endutent,.getut(3C) 

/the index of a symbol table entry of a common object file.ldtbindex(3X) 

/read an indexed symbol table entry of a common object file.ldtbread(3X) 

putpwent: write password file entry.putpwent(3C) 

rje: RJE (Remote Job Entry) to IBM.rje(8) 

unlink: remove directory entry.unlink(2) 

command execution, env: set environment for.env(l) 

environ: user environment.environ(5) 

profile: setting up an environment at login time.profile(4) 

environ: user environment.environ(5) 

execution, env: set environment for command.env(l) 

getenv: return value for environment name.getenv(3C) 

getenv: return Fortran environment variable.getenv(3F) 

sky: obtain ephemerides.sky(6) 

character definitions for eqn and neqn./special .eqnchar(5) 

remove nroff/troff, tbl, and eqn constructs, deroff: .deroff(l) 

mathematical text for nroff/ eqn, neqn, checkeq: format.eqn(l) 

definitions for eqn and neqn. eqnchar: special character.eqnchar(5) 

mrand48,jrand48,/drand48, erand48, lrand48, nrand48,.drand48(3C) 

graphical device/hpd, erase, hardcopy, tekset, td:.gdev(lG) 

complementary error function, erf, erfc: error function and.erf(3M) 

complementary error/ erf, erfc: error function and.erf(3M) 

err: error-logging interface.err(7) 

from dump, errdead: extract error records.errdead(lM) 

daemon, errdemon: error-logging.errdemon(lM) 

format, errfile: error-log file .errfile(4) 

system error/ perror, errno, sys_errlist, sys_nerr:.perror(3C) 

complementary/ erf, erfc: error function and .erf(3M) 

function and complementary error function./erfc: error.erf(3M) 

sys errlist, sys_nerr: system error messages./ermo, .perror(3C) 

to system calls and error numbers./introduction.intro(2) 

errdead: extract error records from dump.errdead(lM) 

matherr: error-handling function.matherr(3M) 

errfile: error-log file format.errfile(4) 

errdemon: error-logging daemon.errdemon(lM) 

errstop: terminate the error-logging daemon.errstop(lM) 

err: error-logging interface.err(7) 

process a report of logged errors, errpt: .errpt(lM) 

hashcheck: find spelling errors./hashmake, spellin,.spell(l) 

logged errors, errpt: process a report of.errpt(lM) 

error-logging daemon, errstop: terminate the.errstop(lM) 

terminal line/ dial: establish an out-going.dial(3C) 

setmnt: establish mount table.setmnt(lM) 

in program, end, etext, edata: last locations.end(3C) 

hypot: Euclidean distance function.hypot(3M) 

expression, expr: evaluate arguments as an .expr(l) 

test: condition evaluation command.test(l) 

vpmfmt: save and print VPM event traces, vpmsave, .vpmsave(lM) 

trace: event-tracing driver.trace(7) 

crash: examine system images.crash(lM) 

execlp, execvp: execute a/ execl, execv, execle, execve,.exec(2) 

execvp: execute/ execl, execv, execle, execve, execlp, .exec(2) 

execl, execv, execle, execve, execlp, execvp: execute a/.exec(2) 

network.net: execute a command on the PCL.net(lC) 

execve, execlp, execvp: execute a file, /execle, .exec(2) 

construct argument list(s) and execute command, xargs:.xargs(l) 

regcmp, regex: compile and execute regular expression.regcmp(3X) 
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Permuted Index 


set environment for command execution, env: .env(l) 

sleep: suspend execution for an interval.sleep(l) 

sleep: suspend execution for interval.sleep(3C) 

monitor: prepare execution profile.monitor(3C) 

profil: execution time profile.profil(2) 

uux: Unix to Unix command execution.uux(lC) 

execvp: execute a/ execl, execv, execle, execve, execlp, .exec(2) 

execute/ execl, execv, execle, execve, execlp, execvp:.exec(2) 

/execv, execle, execve, execlp, execvp: execute a file.exec(2) 

system calls, link, unlink: exercise link and unlink.link(lM) 

a new file or rewrite an existing one. creat: create.creat(2) 

process, exit, _exit: terminate.exit(2) 

exit, exit: terminate process.exit(2) 

exponential intrinsic/ exp, dexp, cexp: Fortran.exp(3F) 

exponential, logarithm,/ exp, log, loglO, pow, sqrt:.exp(3M) 

peat, unpack: compress and expand files, pack,.pack(l) 

cmplx, dcmplx, ichar, char: explicit Fortran type/ /dble, .ftype(3F) 

exp, dexp, cexp: Fortran exponential intrinsic/.exp(3F) 

exp, log, log 10, pow, sqrt: exponential, logarithm, power,/.exp(3M) 

expression, expr: evaluate arguments as an.expr(l) 

routines, regexp: regular expression compile and match .regexp(5) 

regemp: regular expression compile.regcmp(l) 

expr: evaluate arguments as an expression.expr(l) 

compile and execute regular expression, regemp, regex: .regcmp(3X) 

efl: Extended Fortran Language.efl(l) 

greek: graphics for the extended TTY-37 type-box.greek(5) 

dump, errdead: extract error records from.errdead(lM) 

f77: Fortran 77 compiler.f77(l) 

fsplit: split f77, ratfor, or efl files.fsplit(l) 

remainder,/ floor, ceil, fmod, fabs: floor, ceiling,.floor(3M) 

factor: factor a number.factor(l) 

factor: factor a number.factor( 1) 

true, false: provide truth values.true(l) 

data in a machine independent fashion../access long numeric .sputl(3X) 

fine: fast incremental backup.finc(lM) 

procedure, checkall: faster file system checking.checkall(lM) 

abort: generate an lOT fault.abort(3C) 

a stream, fclose, fflush: close or flush .fclose(3S) 

fcntl: file control.fcntl(2) 

fcntl: file control options.fcntl(5) 

floating-point number/ ecvt, fevt, gevt: convert.ecvt(3C) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

status inquiries, ferror, feof, clearerr, fileno: stream .ferror(3S) 

fileno: stream status/ ferror, feof, clearerr, .ferror(3S) 

statistics for a file system, ff: list file names and.ff(lM) 

stream, fclose, fflush: close or flush a.fclose(3S) 

files from the HONEYWELL/ fget, fget.demon: retrieve .fget(lC) 

word from/ getc, getchar, fgetc, getw: get character or .getc(3S) 

from the HONEYWELL/fget, fget.demon: retrieve files .fget(lC) 

stream, gets, fgets: get a string from a.gets(3S) 

pattern, grep, egrep, fgrep: search a file for a.grep(l) 

times, utime: set file access and modification .utime(2) 

Idfcn: common object file access routines.ldfcn(4) 

determine accessibility of a file, access:.access(2) 

hpio: HP 2645A terminal tape file archiver.hpio(l) 

tar: tape file archiver.tar(l) 

cpio: copy file archives in and out.cpio(l) 

pwck, grpek: password/group file checkers.pwck(lM) 

the diagnostic spooler map file, chmap: change .chmap(lM) 

chmod: change mode of file.chmod(2) 

change owner and group of a file, chown: .chown(2) 

diff: differential file comparator.diff(l) 

diff3: 3-way differential file comparison.diff3(l) 

fcntl: file control.fcntl(2) 

fcntl: file control options.fcntl(5) 

uupick: public UNIX-to-UNIX file copy, uuto, .uuto(lC) 

core: format of core image file.core(4) 

cprs: compress an IS25 object file.cprs(l) 

umask: set and get file creation mask.umask(2) 

fields of each line of a file, cut: cut out selected .cut(l) 

dd: convert and copy a file.dd(l) 

a delta (change) to an sees file, delta: make.delta(l) 
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Permuted Index 


close: close a file descriptor.close(2) 

dup: duplicate an open file descriptor.dup(2) 

file: determine file type.file(l) 

selected parts of an object file, dump: dump .dump(l) 

sact: print current sees file editing activity.sact(l) 

setgrent, endgrent: get group file entry, /getgmam,.getgrent(3e) 

endpwent: get password file entry, /setpwent,.getpwent(3e) 

utmpname: access utmp file entry, /endutent, .getut(3e) 

putpwent: write password file entry.putpwent(3e) 

execlp, exeevp: execute a file, /exeev, execle, exeeve, .exec(2) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

Idaopen: open a common object file for reading. Idopen,.ldopen(3X) 

acet: per-process accounting file format.acct(4) 

ar: common archive file format.ar(4) 

ar: archive file format.ar.pdp(4) 

errfile: error-log file format.errfile(4) 

pnch: file format for card images.pnch(4) 

intro: introduction to file formats.intro(4) 

entries of a common object file function, /line number.ldlread(3X) 

get: get a version of an SCCS file.get(l) 

group: group file.group(4) 

files, filehdr: file header for common object .filehdr(4) 

file. Idfhread: read the file header of a common object.ldfhread(3X) 

Idohseek: seek to the optional file header of a common object/.ldohseek(3X) 

fixed-head disk file, hs: RHl 1/RJS03-RJS04.hs(7) 

split: split a file into pieces.split(l) 

issue: issue identification file.issue(4) 

of a member of an archive file, /read the archive header.ldahread(3X) 

close a common object file. Idclose, Idaclose:.ldclose(3X) 

file header of a common object file. Idfhread: read the .ldfhread(3X) 

a section of a common object file, /line number entries of .ldlseek(3X) 

file header of a common object file, /seek to the optional .ldohseek(3X) 

a section of a common object file, /relocation entries of.ldrseek(3X) 

header of a common object file, /indexed/named section.ldshread(3X) 

section of a common object file, /to an indexed/named.ldsseek(3X) 

table entry of a common object file, /the index of a symbol .ldtbindex(3X) 

table entry of a common object file, /read an indexed symbol.ldtbread(3X) 

table of a common object file, /seek to the symbol.ldtbseek(3X) 

entries in a common object file, linenum: line number.linenum(4) 

link: link to a file.link(2) 

listing from 3B20S object file, list: produce C source.list(l) 

mknod: build special file.mknod(lM) 

or a special or ordinary file, /make a directory, .mknod(2) 

ctermid: generate file name for terminal.ctermid(3S) 

mktemp: make a unique filename.mktemp(3C) 

a file system, ff: list file names and statistics for.ff(lM) 

change the format of a text file, newform:.newform(l) 

name list of common object file, nm: print.nm(l) 

null: the null file.null(7) 

/find the slot in the utmp file of the current user.ttyslot(3C) 

/identify processes using a file or file structure.fuser(lM) 

one. creat: create a new file or rewrite an existing .creat(2) 

passwd: password file.passwd(4) 

or subsequent lines of one file./lines of several files .paste(l) 

/rewind, ftell: reposition a file pointer in a stream.fseek(3S) 

Iseek: move read/write file pointer.lseek(2) 

prs: print an SCCS file.prs(l) 

read: read from file.read(2) 

for a common object file, /relocation information .reloc(4) 

rf: RFll/RS 11 fixed-head disk file.rf(7) 

remove a delta from an SCCS file, rmdel:.rmdel(l) 

bfs: big file scanner.bfs(l) 

two versions of an SCCS file, scesdiff: compare .sccsdiff(l) 

scesfile: format of SCCS file.sccsfile(4) 

header for a common object file, scnhdr: section .scnhdr(4) 

stat, fstat: get file status.stat(2) 

from a common object file./line number information .strip(l) 

processes using a file or file structure./identify .fuser(lM) 

checksum and block count of a file, sum: print .sum(l) 

syms: common object file symbol table format.syms(4) 

tapesave: daily/weekly UNIX file system backup, filesave,.filesave(lM) 

procedure, checkall: faster file system checking .checkall(lM) 
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Permuted Index 


and interactive/fsck, dfsck: file system consistency check.fsck(lM) 

fsdb: file system debugger.fsdb(lM) 

names and statistics for a file system, ff: list file .ff(lM) 

volume, file system: format of system.fs(4) 

mkfs: construct a filesystem.mkfs(lM) 

umount: mount and dismount file system, mount,.mount(lM) 

mount: mount a file system.mount(2) 

ustat: get file system statistics.ustat(2) 

mnttab: mounted file system table.mnttab(4) 

umount: unmount a file system.umount(2) 

of 3B20S system description file, system: format .system(4) 

access time, dcopy: copy file systems for optimal.dcopy(lM) 

fsck. checklist: list of file systems processed by .checklist(4) 

volcopy, labelit: copy file systems with label/ .volcopy(lM) 

deliver the last part of a file, tail:.tail(l) 

tmpfile: create a temporary file.tmpfile(3S) 

create a name for a temporary file, tmpnam, tempnam:.tmpnam(3S) 

mkboot: convert a.out file to boot image.mkboot(lM) 

and modification times of a file, touch: update access .touch(l) 

ftw: walk a file tree.ftw(3C) 

file: determine file type.file(l) 

undo a previous get of an sees file, unget:.unget(l) 

report repeated lines in a file, uniq: .uniq(l) 

val: validate sees file.val(l) 

write: write on a file.write(2) 

umask: set file-creation mode mask.umask(l) 

common object files, filehdr: file header for.filehdr(4) 

ferror, feof, clearerr, fileno: stream status/.ferror(3S) 

and print process accounting file(s). acctcom: search.acctcom(l) 

merge or add total accounting files, acetmerg: .acctmerg(lM) 

create and administer sees files, admin: .admin(l) 

send, gath: gather files and/or submit RJE jobs.send(ie) 

VAX-11/780/ fsev: convert files between PDP-11 and.fscv(lM) 

cat: concatenate and print files.cat(l) 

emp: compare two files.cmp(l) 

lines common to two sorted files, comm: select or reject .comm(l) 

cp. In, mv: copy, link or move files.cp(l) 

mark differences between files, diffmk:.diffmk(l) 

file header for common object files, filehdr: .filehdr(4) 

find: find files.find(l) 

free: recover files from a backup tape.frec(lM) 

archive/arcv: convert archive files from PDP-11 to common .arcv(l) 

fget, fget.demon: retrieve files from the HONEYWELL 6000.fget(lC) 

format specification in text files, fspec:.fspec(4) 

split f77, ratfor, or efl files, fsplit:.fsplit(l) 

string, format of graphical files./graphical primitive .gps(4) 

intro: introduction to special files.intro(7) 

link editor for common object files. Id:.ld(l) 

scat: concatenate and print files on synchronous printer.scat(l) 

rm, rmdir: remove files or directories.rm(l) 

/merge same lines of several files or subsequent lines of/ .paste/1) 

unpack: compress and expand files, pack, peat,.pack(l) 

pr: print files.pr(l) 

section sizes of common object files, size: print.size(l) 

size: print sizes of object files.size.pdp(l) 

sort: sort and/or merge files.sort(l) 

NSC network, nusend: send files to another UNIX on the.nusend(lC) 

/convert object and archive files to common formats.convert/1) 

fsend: send files to the HONEYWELL 6000.fsend/lC) 

what: identify SCCS files.what/1) 

daily/weekly UNIX file system/ filesave, tapesave: .filesave/lM) 

greek: select terminal filter.greek/1) 

nl: line numbering filter.nl/1) 

col: filter reverse line-feeds.col/1) 

graphical device routines and filters./tekset, td: .gdev/lG) 

tplot: graphics filters.tplot/lG) 

fine: fast incremental backup.fine/ IM) 

find: find files.find/1) 

find: find files.find/1) 

hyphen: find hyphenated words.hyphen/1) 

ttyname, isatty: find name of a terminal.ttyname/3C) 

object library, lorder: find ordering relation for an .lorder/1) 
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Permuted Index 


hashmake, spellin, hashcheck: find spelling errors, spell,.spell(l) 

/dstop, dstat: start, stop and find status of on-line/.dstart(lM) 

diagnostic requests, sta: find status of pending on-line.sta(lM) 

of the current user, ttyslot: find the slot in the utmp file .ttyslot(3C) 

tee: pipe fitting.tee(l) 

hs: RH11/RJS03-RJS04 fixed-head disk file.hs(7) 

rf: RFl 1/RS11 fixed-head disk file.rf(7) 

int, ifix, idint, real, float, sngl, dble, cmplx,/.ftype(3F) 

atof: convert ASCII string to floating-point number.atof(3C) 

ecvt, fcvt, gcvt: convert floating-point number to/ .ecvt(3C) 

/modf: manipulate parts of floating-point numbers.frexp(3C) 

floor, ceiling, remainder,/ floor, ceil, fmod, fabs: .floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder,/ .floor(3M) 

vlx: VAX-11/780 LSI console floppy interface.vlx(lM) 

cflow: generate C flow graph.cflow(l) 

fclose, fflush: close or flush a stream.fclose(3S) 

remainder,/ floor, ceil, fmod, fabs: floor, ceiling, .floor(3M) 

stream, fopen, freopen, fdopen: open a.fopen(3S) 

fork: create a new process.fork(2) 

per-process accounting file format, acct: .acct(4) 

dskfmt, dskvfy: format and verify disk packs.dskfmt(lM) 

RM05 disk packs, format: format and/or check RP06 and .format(lM) 

ar: common archive file format.ar(4) 

from PDF-11 to common archive format./convert archive files.arcv(l) 

ar: archive file format.ar.pdp(4) 

errfile: error-log file format.errfile(4) 

pnch: file format for card images.pnch(4) 

RP06 and RM05 disk packs, format: format and/or check .format(lM) 

nroff or/eqn, neqn, checkeq: format mathematical text for.eqn(l) 

description file, system: format of 3B20S system.system(4) 

newform: change the format of a text file.newform(l) 

inode: format of an inode.inode(4) 

core: format of core image file.core(4) 

cpio: format of cpio archive.cpio(4) 

dir: format of directories.dir(4) 

/graphical primitive string, format of graphical files.gps(4) 

sccsfile: format of SCCS file.sccsfile(4) 

file system: format of system volume.fs(4) 

files, fspec: format specification in text.fspec(4) 

object file symbol table format, syms: common.syms(4) 

troff. tbl: format tables for nroff or .tbl(l) 

nroff: format text.nroff(l) 

and archive files to common formats./convert object.convert(l) 

intro: introduction to file formats.intro(4) 

wtmp: utmp and wtmp entry formats, utmp, .utmp(4) 

scanf, fscanf, sscanf: convert formatted input.scanf(3S) 

fprintf, sprintf: print formatted output, printf,.printf(3S) 

/checkmm: print/check documents formatted with the MM macros.mm(l) 

mptx: the macro package for formatting a permuted index.mptx(5) 

mm: the MM macro package for formatting documents.mm(5) 

OSDD adapter macro package for formatting documents./the .mosd(5) 

manual, man: macros for formatting entries in this.man(5) 

f77: Fortran 77 compiler.f77(l) 

abs, iabs, dabs, cabs, zabs: Fortran absolute value.abs(3F) 

system/ signal: specify Fortran action on receipt of a.signal(3F) 

function, acos, dacos: Fortran arccosine intrinsic.acos(3F) 

function, asin, dasin: Fortran arcsine intrinsic.asin(3F) 

function. atan2, datan2: Fortran arctangent intrinsic.atan2(3F) 

function, atan, datan: Fortran arctangent intrinsic.atan(3F) 

or, xor, not, Ishift, rshift: Fortran bitwise boolean/ and,.bool(3F) 

getarg: return Fortran command-line argument.getarg(3F) 

logic, aloglO, dloglO: Fortran common logarithm/ .loglO(3F) 

intrinsic/ conjg, dconjg: Fortran complex conjugate.conjg(3F) 

function, cos, dcos, ccos: Fortran cosine intrinsic.cos(3F) 

ratfor: rational Fortran dialect.ratfor(l) 

getenv: return Fortran environment variable.getenv(3F) 

function, exp, dexp, cexp: Fortran exponential intrinsic.exp(3F) 

intrinsic/ cosh, dcosh: Fortran hyperbolic cosine.cosh(3F) 

intrinsic/ sinh, dsinh: Fortran hyperbolic sine.sinh(3F) 

intrinsic/ tanh, dtanh: Fortran hyperbolic tangent.tanh(3F) 

complex/ aimag, dimag: Fortran imaginary part of .aimag(3F) 

function, aint, dint: Fortran integer part intrinsic.aint(3F) 
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Permuted Index 


efl: Extended Fortran Language.efl(l) 

amaxO, maxi, amaxl, dmaxl: Fortran maximum-value//maxO, .max(3F) 

aminO, mini, aminl, dminl: Fortran minimum-value//minO,.min(3F) 

log, alog, dlog, clog: Fortran natural logarithm/.log(3F) 

anint, dnint, nint, idnint: Fortran nearest integer/.round(3F) 

abort: terminate Fortran program.abort(3F) 

functions, mod, amod, dmod: Fortran remaindering intrinsic .mod(3F) 

function, sin, dsin, csin: Fortran sine intrinsic.sin(3F) 

function, sqrt, dsqrt, csqrt: Fortran square root intrinsic .sqrt(3F) 

len: return length of Fortran string.len(3F) 

index: return location of Fortran substring.index(3F) 

issue a shell command from Fortran, system:.system(3F) 

function, tan, dtan: Fortran tangent intrinsic.tan(3F) 

mclock: return Fortran time accounting.mclock(3F) 

intrinsic/ sign, isign, dsign: Fortran transfer-of-sign.sign(3F) 

/dcmplx, ichar, char: explicit Fortran type conversion.ftype(3F) 

generator, srand, rand: Fortran uniform random-number .rand(3F) 

formatted output, printf, fprintf, sprintf: print .printf(3S) 

word on a/ putc, putchar, fputc, putw: put character or.putc(3S) 

stream, puts, fputs: put a string on a .puts(3S) 

input/output, fread, fwrite: binary .fread(3S) 

backup tape, free: recover files from a.frec(lM) 

df: report number of free disk blocks.df(lM) 

memory allocator, malloc, free, realloc, calloc: main .malloc(3C) 

stream, fopen, freopen, fdopen: open a.fopen(3S) 

parts of floating-point/ frexp, Idexp, modf: manipulate.frexp(3C) 

list: produce C source listing from 3B20S object file.list(l) 

free: recover files from a backup tape.frec(lM) 

/and line number information from a common object file.strip/1) 

gets, fgets: get a string from a stream.gets(3S) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

getopt: get option letter from argument vector.getopt(3C) 

errdead: extract error records from dump.errdead(lM) 

read: read from file.read(2) 

system: issue a shell command from Fortran.system(3F) 

ncheck: generate names from i-numbers.ncheck(lM) 

nlist: get entries from name list.nlist(3C) 

arev: convert archive files from PDF-11 to common archive/.arcv(l) 

acetems: command summary from per-process accounting/.acctcms(lM) 

diagnostics, rmv: remove unit from service before on-line.rmv(lM) 

getw: get character or word from stream./getchar, fgetc,.getc(3S) 

Idtape: load disk from tape procedures.ldtape(8) 

/fget.demon: retrieve files from the HONEYWELL 6000.fget(lC) 

nsetorje: re-route jobs from the NSC network to RJE.nsctorje(lC) 

getpw: get name from UID.getpw(3C) 

formatted input, scanf, fscanf, sscanf: convert .scanf(3S) 

of file systems processed by fsek. checklist: list.checklist(4) 

consistency check and/ fsck, dfsck: file system .fsck(lM) 

PDP-11 and VAX-11/780/ fsev: convert files between.fscv(lM) 

fsdb: file system debugger.fsdb(lM) 

reposition a file pointer in/ fseek, rewind, ftell:.fseek(3S) 

HONEYWELL 6000. fsend: send files to the .fsend(lC) 

text files, fspec: format specification in.fspec(4) 

efl files, fsplit: split f77, ratfor, or .fsplit(l) 

stat, fstat: get file status.stat(2) 

pointer in a/ fseek, rewind, ftell: reposition a file.fseek(3S) 

fts: Field Test Set interface.fts(lM) 

ftw: walk a file tree.ftw(3C) 

Fortran arccosine intrinsic function, acos, dacos:.acos(3F) 

Fortran integer part intrinsic function, aint, dint:.aint(3F) 

error/ erf, erfc: error function and complementary.erf(3M) 

Fortran arcsine intrinsic function, asin, dasin:.asin(3F) 

Fortran arctangent intrinsic function. atan2, datan2:.atan2(3F) 

Fortran arctangent intrinsic function, atan, datan:.atan(3F) 

complex conjugate intrinsic function, /dconjg: Fortran.conjg(3F) 

ccos: Fortran cosine intrinsic function, cos, dcos, .cos(3F) 

hyperbolic cosine intrinsic function, /dcosh: Fortran .cosh(3F) 

and complementary error function, /error function.erf(3M) 

Fortran exponential intrinsic function, exp, dexp, cexp:.exp(3F) 

gamma: log gamma function.gamma(3M) 

hypot: Euclidean distance function.hypot(3M) 

of a common object file function./line number entries .ldlread(3X) 
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Permuted Index 


common logarithm intrinsic function./dloglO: Fortran.loglO(3F) 

natural logarithm intrinsic function, /dlog, clog: Fortran.log(3F) 

matherr: error-handling function.matherr(3M) 

transfer-of-sign intrinsic function, /dsign: Fortran .sign(3F) 

csin: Fortran sine intrinsic function, sin, dsin,.sin(3F) 

hyperbolic sine intrinsic function, /dsinh: Fortran .sinh(3F) 

Fortran square root intrinsic function, sqrt, dsqrt, csqrt:.sqrt(3F) 

Fortran tangent intrinsic function, tan, dtan:.tan(3F) 

hyperbolic tangent intrinsic function, /dtanh: Fortran .tanh(3F) 

jO,jl, jn, yO, yl, yn: Bessel functions.bessel(3M) 

Fortran bitwise boolean functions. /Ishift, rshift:.bool(3F) 

perform 3270 emulation control functions, emulcntrl:.emulcntrl(lM) 

logarithm, power, square root functions, /sqrt: exponential,.exp(3M) 

remainder, absolute value functions, /floor, ceiling, .floor(3M) 

dmaxl: Fortran maximum-value functions./maxi, amaxl,.max(3F) 

dminl: Fortran minimum-value functions./mini, aminl, .min(3F) 

Fortran remaindering intrinsic functions, mod, amod, dmod: .mod(3F) 

the NSC local network loopback functions, nscloop: perform .nscloop(lM) 

300, 300s: handle special functions of DASI 300 and 300s/. 300(1) 

hp: handle special functions of HP 2640 and/.hp(l) 

terminal. 450: handle special functions of the DASI 450 . 450(1) 

Fortran nearest integer functions./nint, idnint:.round(3F) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

atan, atan2: trigonometric functions, /tan, asin, acos,.trig(3M) 

using a file or file/ fuser: identify processes.fuser(lM) 

fread, fwrite: binary input/output.fread(3S) 

connect accounting records, fwtmp, wtmpfix: manipulate.fwtmp(lM) 

jotto: secret word game.jotto(6) 

moo: guessing game.moo(6) 

back: the game of backgammon.back(6) 

bj: the game of blackjack.bj(6) 

chess: the game of chess.chess(6) 

craps: the game of craps.craps(6) 

reversi: a game of dramatic reversals.reversi(6) 

wump: the game of hunt-the-wumpus.wump(6) 

intro: introduction to games.intro(6) 

gamma: log gamma function.gamma(3M) 

gamma: log gamma function.gamma(3M) 

submit RJE jobs, send, gath: gather files and/or.send(lC) 

jobs, send, gath: gather files and/or submit RJE .send(lC) 

output to the HONEYWELL 6000. gcat: send phototypesetter.gcat(lC) 

user, gcosmail: send mail to HIS .gcosmail(lC) 

number to string, ecvt, fcvt, gcvt: convert floating-point .ecvt(3C) 

moving-head disks, gd: general driver for.gd(7) 

ged: graphical editor.ged(lG) 

maze: generate a maze.maze(6) 

abort: generate an lOT fault.abort(3C) 

cflow: generate C flow graph.cflow(l) 

reference, cxref: generate C program cross .cxref(l) 

crypt, setkey, encrypt: generate DES encryption.crypt(3C) 

makekey: generate encryption key.makekey(l) 

terminal, ctermid: generate file name for.ctermid(3S) 

ncheck: generate names from i-numbers.ncheck(lM) 

lexical tasks, lex: generate programs for simple.lex(l) 

/srand48, seed48, lcong48: generate uniformly distributed/.drand48(3C) 

srand: simple random-number generator, rand,.rand(3C) 

Fortran uniform random-number generator, srand, rand: .rand(3F) 

controller/terminal/emulstat: get 3270 emulation.emulstat(lM) 

gets, fgets: get a string from a stream.gets(3S) 

get: get a version of an SCCS file.get(l) 

ulimit: get and set user limits.ulimit(2) 

the user, cuserid: get character login name of .cuserid(3S) 

getc, getchar, fgetc, getw: get character or word from/ .getc(3S) 

nlist: get entries from name list.nlist(3C) 

umask: set and get file creation mask.umask(2) 

stat, fstat: get file status.stat(2) 

ustat: get file system statistics.ustat(2) 

file, get: get a version of an SCCS.get(l) 

/getgmam, setgrent, endgrent: get group file entry.getgrent(3C) 

getlogin: get login name.getlogin(3C) 

logname: get login name.logname(l) 

msgget: get message queue.msgget(2) 
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Permuted Index 


getpw: get name from UID.getpw(3C) 

system, uname: get name of current UNIX.uname(2) 

unget: undo a previous get of an SCCS file.unget(l) 

argument vector, getopt: get option letter from.getopt(3C) 

/getpwnam, setpwent, endpwent: get password file entry.getpwent(3C) 

working directory, getcwd: get path-name of current.getcwd(3C) 

times, times: get process and child process.times(2) 

and/ getpid, getpgrp, getppid: get process, process group,.getpid(2) 

/geteuid, getgid, getegid: get real user, effective user,/.getuid(2) 

semget: get set of semaphores.semget(2) 

shmget: get shared memory segment.shmget(2) 

/x251nk: install, remove, or get status for a BX.25 minor/.x25pvc(lM) 

tty: get the terminal’s name.tty(l) 

time: get time.time(2) 

command-line argument, getarg: return Fortran.getarg(3F) 

get character or word from/ getc, getchar, fgetc, getw:.getc(3S) 

character or word from/getc, getchar, fgetc, getw: get.getc(3S) 

current working directory, getcwd: get path-name of.getcwd(3C) 

getuid, geteuid, getgid, getegid: get real user,/.getuid(2) 

environment variable, getenv: return Fortran.getenv(3F) 

environment name, getenv: return value for.getenv(3C) 

real user, effective/ getuid, geteuid, getgid, getegid: get .getuid(2) 

user,/ getuid, geteuid, getgid, getegid: get real.getuid(2) 

setgrent, endgrent: get group/ getgrent, getgrgid, getgmam,.getgrent(3C) 

endgrent: get group/ getgrent, getgrgid, getgmam, setgrent,.getgrent(3C) 

get group/getgrent, getgrgid, getgmam, setgrent, endgrent:.getgrent(3C) 

getlogin: get login name.getlogin(3C) 

argument vector, getopt: get option letter from.getopt(3C) 

getopt: parse command options.getopt(l) 

getpass: read a password.getpass(3C) 

process group, and/ getpid, getpgrp, getppid: get process,.getpid(2) 

process, process group, and/ getpid, getpgrp, getppid: get.getpid(2) 

group, and/ getpid, getpgrp, getppid: get process, process.getpid(2) 

getpw: get name from UID.getpw(3C) 

setpwent, endpwent: get/ getpwent, getpwuid, getpwnam,.getpwent(3C) 

get/ getpwent, getpwuid, getpwnam, setpwent, endpwent: .getpwent(3C) 

endpwent: get/ getpwent, getpwuid, getpwnam, setpwent,.getpwent(3C) 

a stream, gets, fgets: get a string from .gets(3S) 

and terminal settings used by getty. gettydefs: speed .gettydefs(4) 

modes, speed, and line/ getty: set terminal type,.getty(lM) 

ct: spawn getty to a remote terminal.ct(lC) 

settings used by getty. gettydefs: speed and terminal.gettydefs(4) 

getegid: get real user,/ getuid, geteuid, getgid, .getuid(2) 

pututline, setutent,/ getutent, getutid, getutline,.getut(3C) 

setutent, endutent,/ getutent, getutid, getutline, pututline, .getut(3C) 

setutent,/ getutent, getutid, getutline, pututline,.getut(3C) 

from/getc, getchar, fgetc, getw: get character or word .getc(3S) 

convert/ ctime, localtime, gmtime, asctime, tzset: .ctime(3C) 

setjmp, longjmp: non-local goto.setjmp(3C) 

string, format of graphical/ gps: graphical primitive.gps(4) 

cflow: generate C flow graph.cflow(l) 

graph: draw a graph.graph(lG) 

graph: draw a graph.graph(lG) 

sag: system activity graph.sag(lG) 

commands, graphics: access graphical and numerical.graphics(lG) 

/network useful with graphical commands.stat(lG) 

/erase, hardcopy, tekset, td: graphical device routines and/ .gdev(lG) 

ged: graphical editor.ged(lG) 

primitive string, format of graphical files./graphical.gps(4) 

format of graphical/ gps: graphical primitive string,.gps(4) 

routines, toe: graphical table of contents.toc(lG) 

gutil: graphical utilities.gutil(lG) 

numerical commands, graphics: access graphical and .graphics(lG) 

tplot: graphics filters.tplot(lG) 

TTY-37 type-box. greek: graphics for the extended .greek(5) 

plot: graphics interface.plot(4) 

subroutines, plot: graphics interface .plot(3X) 

mvt: typeset documents, view graphs, and slides, mmt, .mmt(l) 

package for typesetting view graphs and slides./macro.mv(5) 

extended TTY-37 type-box. greek: graphics for the .greek(5) 

greek: select terminal filter.greek(l) 

file for a pattern, grep, egrep, fgrep: search a.grep(l) 
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Permuted Index 


/user, effective user, real group, and effective group/.getuid(2) 

/getppid: get process, process group, and parent process IDs.getpid(2) 

chown, chgrp: change owner or group.chown(l) 

setgrent, endgrent: get group file entry, /getgmam, .getgrent(3C) 

group: group file.group(4) 

group: group file.group(4) 

setpgrp: set process group ID.setpgrp(2) 

id: print user and group IDs and names.id(l) 

real group, and effective group IDs. /effective user,.getuid(2) 

setuid, setgid: set user and group IDs.setuid(2) 

newgrp: log in to a new group.newgrp(l) 

chown: change owner and group of a file.chown(2) 

a signal to a process or a group of processes./send.kill(2) 

update, and regenerate groups of programs./maintain,.make(l) 

checkers, pwck, grpck: password/group file.pwck(lM) 

ssignal, gsignal: software signals.ssignal(3C) 

drives, gt: general driver for tape .gt(7) 

hangman: guess the word.hangman(6) 

moo: guessing game.moo(6) 

gutil: graphical utilities.gutil(lG) 

x25hlnk, x25dlnk: halt or detach a BX.25 link.x25hlnk(3C) 

DASI 300 and 300s/ 300, 300s: handle special functions of. 300(1) 

2640 and 2621-series/hp: handle special functions of HP.hp(l) 

the DASI 450 terminal. 450: handle special functions of. 450(1) 

hangman: guess the word.hangman(6) 

nohup: run a command immune to hangups and quits.nohup(l) 

graphical device/hpd, erase, hardcopy, tekset, td: .gdev(lG) 

hcreate, hdestroy: manage hash search tables, hsearch, .hsearch(3C) 

spell, hashmake, spellin, hashcheck: find spelling/ .spell(l) 

find spelling errors, spell, hashmake, spellin, hashcheck: .spell(l) 

search tables, hsearch, hcreate, hdestroy: manage hash.hsearch(3C) 

tables, hsearch, hcreate, hdestroy: manage hash search .hsearch(3C) 

file, scnhdr: section header for a common object .scnhdr(4) 

files, filehdr: file header for common object.filehdr(4) 

file. Idfhread: read the file header of a common object.ldfhread(3X) 

/seek to the optional file header of a common object/ .ldohseek(3X) 

/read an indexed/named section header of a common object/ .ldshread(3X) 

Idahread: read the archive header of a member of an/.ldahread(3X) 

help: ask for help.help(l) 

help: ask for help.help(l) 

hm: RM05 moving-head disk.hm(7) 

retrieve files from the HONEYWELL 6000./fget.demon: .fget(lC) 

fsend: send files to the HONEYWELL 6000.fsend(lC) 

phototypesetter output to the HONEYWELL 6000. gcat: send.gcat(lC) 

printer daemon, dpd, Ipd: HONEYWELL sending daemon, line .dpd(lC) 

handle special functions of HP 2640 and 2621-series/hp: .hp(l) 

archiver, hpio: HP 2645A terminal tape file.hpio(l) 

of HP 2640 and 2621-series/ hp: handle special functions .hp(l) 

moving-head disk, hp: RP04/RP05/RP06.hp(7) 

td: graphical device routines/ hpd, erase, hardcopy, tekset,.gdev(lG) 

file archiver, hpio: HP 2645A terminal tape .hpio(l) 

fixed-head disk file, hs: RHl 1/RJS03-RJS04.hs(7) 

manage hash search tables, hsearch, hcreate, hdestroy:.hsearch(3C) 

interface, ht: TUI6/TE16 magnetic tape .ht(7) 

wump: the game of hunt-the-wumpus.wump(6) 

cosh, dcosh: Fortran hyperbolic cosine intrinsic/.cosh(3F) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

sinh, dsinh: Fortran hyperbolic sine intrinsic/ .sinh(3F) 

tanh, dtanh: Fortran hyperbolic tangent intrinsic/.tanh(3F) 

hyphen: find hyphenated words.hyphen(l) 

hyphen: find hyphenated words.hyphen(l) 

function, hypot: Euclidean distance.hypot(3M) 

Fortran absolute value, abs, iabs, dabs, cabs, zabs:.abs(3F) 

rje: RJE (Remote Job Entry) to IBM.rje(8) 

/sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran/ .ftype(3F) 

semaphore set or shared memory id./remove a message queue, .ipcrm(l) 

and names, id: print user and group IDs .id(l) 

setpgrp: set process group ID.setpgrp(2) 

issue: issue identification file.issue(4) 

file or file/fuser: identify processes using a.fuser(lM) 

what: identify sees files.what(l) 

dble, cmplx,/ int, ifix, idint, real, float, sngl,.ftype(3F) 
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Permuted Index 


integer/ anint, dnint, nint, idnint: Fortran nearest.round(3F) 

id: print user and group IDs and names.id(l) 

group, and parent process IDs. /get process, process.getpid(2) 

group, and effective group IDs. /effective user, real.getuid(2) 

setgid: set user and group IDs. setuid,.setuid(2) 

sngl, dble, cmplx,/ int, ifix, idint, real, float, .ftype(3F) 

core: format of core image file.core(4) 

convert a.out file to boot image, mkboot:.mkboot(lM) 

crash: examine system images.crash(lM) 

pnch: file format for card images.pnch(4) 

aimag, dimag: Fortran imaginary part of complex/ .aimag(3F) 

nohup: run a command immune to hangups and quits.nohup(l) 

fine: fast incremental backup.finc(lM) 

long numeric data in a machine independent fashion../access.sputl(3X) 

for formatting a permuted index, /the macro package.mptx(5) 

of a/ Idtbindex: compute the index of a symbol table entry.ldtbindex(3X) 

ptx: permuted index.ptx(l) 

Fortran substring, index: return location of.index(3F) 

a common/ Idtbread: read an indexed symbol table entry of .ldtbread(3X) 

Idshread, Idnshread: read an indexed/named section header/.ldshread(3X) 

Idsseek, Idnsseek: seek to an indexed/named section of a/.ldsseek(3X) 

inittab: script for the init process.inittab(4) 

initialization, init, telinit: process control.init(lM) 

init, telinit: process control initialization.init(lM) 

/rc, powerfail: system initialization shell scripts.brc(lM) 

dgn: initiate on-line diagnostics.dgn(lM) 

process, popen, pclose: initiate pipe to/from a.popen(3S) 

process, inittab: script for the init.inittab(4) 

clri: clear i-node.clri(lM) 

inode: format of an inode.inode(4) 

inode: format of an inode.inode(4) 

ipb: read the EAI Input Parameter Buffer.ipb(lM) 

sscanf: convert formatted input, scanf, fscanf, .scanf(3S) 

push character back into input stream, ungetc:.ungetc(3S) 

fread, fwrite: binary input/output.fread(3S) 

stdio: standard buffered input/output package.stdio(3S) 

fileno: stream status inquiries, /feof, clearerr,.ferror(3S) 

uustat: uucp status inquiry and job control.uustat(lC) 

x25alnk, x25ilnk: attach or install a BX.25 link.x25alnk(3C) 

install: install commands.install(lM) 

install: install commands.install(lM) 

link. x25ipvc, x25rpvc: install or remove a PVC on a.x25ipvc(3C) 

for a BX.25/x25pvc, x251nk: install, remove, or get status .x25pvc(lM) 

sngl, dble, cmplx, dcmplx,/ int, ifix, idint, real, float,.ftype(3F) 

abs: return integer absolute value.abs(3C) 

/164a: convert between long integer and base-64 ASCII/ .a641(3C) 

nint, idnint: Fortran nearest integer functions./dnint, .round(3F) 

function, aint, dint: Fortran integer part intrinsic .aint(3F) 

atol, atoi: convert string to integer, strtol,.strtol(3C) 

/ltol3: convert between 3-byte integers and long integers.13tol(3C) 

3-byte integers and long integers./convert between.13tol(3C) 

bcopy: interactive block copy.bcopy(lM) 

system consistency check and interactive repair, /file .fsck(lM) 

rjestat: RJE status report and interactive status console.rjestat(lC) 

dn: Automatic Call Unit (ACU) interface, acu,.acu(7) 

cat: phototypesetter interface.cat(7) 

dgn: on-line diagnostic interface.dgn(7) 

du: DU-11 synchronous line interface.du(7) 

eai: 3B20S emergency action interface.eai(8) 

emulio: 3270 emulation interface.emulio(7) 

err: error-logging interface.err(7) 

fts: Field Test Set interface.fts(lM) 

ht: TU16/TE16 magnetic tape interface.ht(7) 

KL-11 or DL-11 asynchronous interface, kl: .kl(7) 

msi: memory system diagnostic interface.msi(lM) 

parallel communications link interface, pci:.pcl(7) 

plot: graphics interface.plot(4) 

nsc: NSC adapter interface specification.nsc(7) 

St: synchronous terminal interface.st(7) 

general synchronous terminal interface, stermio:.stermio(7) 

plot: graphics interface subroutines.plot(3X) 

termio: general terminal interface.termio(7) 
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Permuted Index 


tm: TMll/TUlO magnetic tape interface.tm(7) 

tn4: eight line asynchronous interface.tn4(7) 

tn74: two line asynchronous interface.tn74(7) 

tn83: console/printer interface.tn83(7) 

messages, osm: interface to UNIX system.osm(7) 

ts: TSl 1 magnetic tape interface.tsll(7) 

tty: controlling terminal interface.tty(7) 

tu78: TU78 magnetic tape interface.tu78(7) 

un32: magnetic tape interface.un32(7) 

un52: magnetic tape interface.un52(7) 

synchronous device interface. /UN53/TN82.un53(7) 

VAX-11/780 LSI console floppy interface, vlx:.vlx(lM) 

x25: BX.25 network interface.x25(7) 

spline: interpolate smooth curve.spline(lG) 

characters, asa: interpret ASA carriage control .asa(l) 

sno: SNOBOL interpreter.sno(l) 

pipe: create an interprocess channel.pipe(2) 

facilities/ipcs: report inter-process communication.ipcs(l) 

package, stdipc: standard interprocess communication.stdipc(3C) 

suspend execution for an interval, sleep: .sleep/1) 

sleep: suspend execution for interval.sleep(3C) 

acos, dacos: Fortran arccosine intrinsic function.acos(3F) 

dint: Fortran integer part intrinsic function, aint,.aint(3F) 

asin, dasin: Fortran arcsine intrinsic function.asin(3F) 

datan2: Fortran arctangent intrinsic function. atan2, .atan2(3F) 

datan: Fortran arctangent intrinsic function, atan,.atan(3F) 

Fortran complex conjugate intrinsic function, /dconjg:.conjg(3F) 

dcos, ccos: Fortran cosine intrinsic function, cos, .cos(3F) 

Fortran hyperbolic cosine intrinsic function, /dcosh:.cosh(3F) 

cexp: Fortran exponential intrinsic function, /dexp, .exp(3F) 

Fortran common logarithm intrinsic function. /dloglO:.logl0(3F) 

Fortran natural logarithm intrinsic function, /clog:.log(3F) 

Fortran transfer-of-sign intrinsic function, /dsign: .sign(3F) 

sin, dsin, csin: Fortran sine intrinsic function.sin(3F) 

dsinh: Fortran hyperbolic sine intrinsic function, sinh,.sinh(3F) 

csqrt: Fortran square root intrinsic function, /dsqrt, .sqrt(3F) 

tan, dtan: Fortran tangent intrinsic function.tan(3F) 

Fortran hyperbolic tangent intrinsic function, /dtanh:.tanh(3F) 

dmod: Fortran remaindering intrinsic functions, /amod,.mod(3F) 

commands and application/ intro: introduction to.intro(l) 

formats, intro: introduction to file.intro(4) 

intro: introduction to games.intro(6) 

miscellany, intro: introduction to.intro(5) 

files, intro: introduction to special.intro(7) 

subroutines and libraries, intro: introduction to.intro(3) 

calls and error numbers, intro: introduction to system.intro(2) 

maintenance commands and/ intro: introduction to system.intro(lM) 

maintenance procedures, intro: introduction to system.intro(8) 

application programs, intro: introduction to commands and .intro(l) 

intro: introduction to file formats.intro(4) 

intro: introduction to games.intro(6) 

intro: introduction to miscellany.intro(5) 

intro: introduction to special files.intro(7) 

and libraries, intro: introduction to subroutines.intro(3) 

and error numbers, intro: introduction to system calls .intro(2) 

maintenance commands/intro: introduction to system .intro(lM) 

maintenance/ intro: introduction to system .intro(8) 

ncheck: generate names from i-numbers.ncheck(lM) 

ioctl: control device.ioctl(2) 

abort: generate an lOT fault.abort(3C) 

Parameter Buffer, ipb: read the EAI Input.ipb(lM) 

semaphore set or shared/ ipcrm: remove a message queue, .ipcrm(l) 

communication facilities/ ipcs: report inter-process .ipcs(l) 

cprs: compress an IS25 object file.cprs(l) 

/islower, isdigit, isxdigit, isalnum, isspace, ispunct,/.ctype(3C) 

isdigit, isxdigit, isalnum,/ isalpha, isupper, islower, .ctype(3C) 

/isprint, isgraph, iscntrl, isascii: classify characters.ctype(3C) 

terminal, ttyname, isatty: find name of a.ttyname(3C) 

/ispunct, isprint, isgraph, iscntrl, isascii: classify/.ctype(3C) 

isalpha, isupper, islower, isdigit, isxdigit, isalnum,/.ctype(3C) 

/isspace, ispunct, isprint, isgraph, iscntrl, isascii:/.ctype(3C) 

transfer-of-sign/ sign, isign, dsign: Fortran .sign(3F) 
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Permuted Index 


isalnum,/ isalpha, isupper, islower, isdigit, isxdigit,.ctype(3C) 

/isalnum, isspace, ispunct, isprint, isgraph, iscntrl,/.ctype(3C) 

/isxdigit, isalnum, isspace, ispunct, isprint, isgraph,/ .ctype(3C) 

/isdigit, isxdigit, isalnum, isspace, ispunct, isprint,/.ctype(3C) 

Fortran, system: issue a shell command from .system(3F) 

system: issue a shell command.system(3S) 

issue: issue identification file.issue(4) 

file, issue: issue identification .issue(4) 

isxdigit, isalnum,/ isalpha, isupper, islower, isdigit,.ctype(3C) 

/isupper, islower, isdigit, isxdigit, isalnum, isspace,/.ctype(3C) 

news: print news items.news(l) 

functions. jO,jl, jn, yO, yl, yn: Bessel .bessel(3M) 

functions. jO, jl, jn, yO, yl, yn: Bessel.bessel(3M) 

bj: the game of black jack.bj(6) 

functions. jO,jl, jn, yO, yl, yn: Bessel.bessel(3M) 

operator, join: relational database.join(l) 

jotto: secret word game.jotto(6) 

/lrand48, nrand48, mrand48, jrand48, srand48, seed48,/.drand48(3C) 

assembler/un-assemblerfor/ kasb, kunb:.kasb(l) 

makekey: generate encryption key.makekey(l) 

killall: kill all active processes.killall(lM) 

process or a group of/ kill: send a signal to a.kill(2) 

kill: terminate a process.kill(l) 

processes, killall: kill all active .killall(lM) 

asynchronous interface, kl: KL-11 or DL-11 .kl(7) 

interface, kl: KL-11 or DL-11 asynchronous.kl(7) 

microprocessor, kmc: KMC-1 IB/KMSl 1 .kmc(7) 

vpmtest: test KMC lines.vpmtest(lM) 

/assembler/un-assembler for the KMCl IB microprocessor.kasb(l) 

microprocessor, kmc: KMC-llB/KMSll.kmc(7) 

mem, kmem: core memory.mem(7) 

quiz: test your knowledge.quiz(6) 

for the KMCl IB/kasb, kunb: assembler/un-assembler .kasb(l) 

3-byte integers and long/ 13tol, ltol3: convert between.13tol(3C) 

integer and base-64/ a641, 164a: convert between long.a641(3C) 

copy file systems with label checking./labelit:.volcopy(lM) 

with label checking, volcopy, labelit: copy file systems .volcopy(lM) 

scanning and processing language, awk: pattern.awk(l) 

arbitrary-precision arithmetic language, be:.bc(l) 

efl: Extended Fortran Language.efl(l) 

epp: the C language preprocessor.cpp(l) 

command programming language./standard/restricted .sh(l) 

chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm,/.acctsh(lM) 

load VTOC, prom patch, or Iboot. newboot:.newboot(lM) 

/jrand48, srand48, seed48, lcong48: generate uniformly/.drand48(3C) 

object files. Id: link editor for common.ld(l) 

Id: link editor.Id.pdp(l) 

object file. Idclose, Idaclose: close a common.ldclose(3X) 

header of a member of an/ Idahread: read the archive.ldahread(3X) 

file for reading. Idopen, Idaopen: open a common object.ldopen(3X) 

common object file. Idclose, Idaclose: close a.ldclose(3X) 

of floating-point/ frexp, Idexp, modf: manipulate parts .frexp(3C) 

access routines. Idfcn: common object file.ldfcn(4) 

of a common object file. Idfhread: read the file header.ldfhread(3X) 

line number entries/ Idlread, Idlinit, Idlitem: manipulate.ldlread(3X) 

number/ Idlread, Idlinit, Idlitem: manipulate line.ldlread(3X) 

manipulate line number/ Idlread, Idlinit, Idlitem: .ldlread(3X) 

number entries of a section/ ldlseek,ldnlseek: seek to line.ldlseek(3X) 

entries of a section/ Idrseek, Idnrseek: seek to relocation .ldrseek(3X) 

indexed/named/ Idshread, Idnshread: read an.ldshread(3X) 

indexed/named/ Idsseek, Idnsseek: seek to an .ldsseek(3X) 

file header of a common/ Idohseek: seek to the optional.ldohseek(3X) 

object file for reading. Idopen, Idaopen: open a common.ldopen(3X) 

relocation entries of a/ Idrseek, Idnrseek: seek to .ldrseek(3X) 

indexed/named section header/ Idshread, Idnshread: read an .ldshread(3X) 

indexed/named section of a/ Idsseek, Idnsseek: seek to an.ldsseek(3X) 

procedures. Idtape: load disk from tape.ldtape(8) 

of a symbol table entry of a/ Idtbindex: compute the index.ldtbindex(3X) 

symbol table entry of a/ Idtbread: read an indexed .ldtbread(3X) 

table of a common object/ Idtbseek: seek to the symbol.ldtbseek(3X) 

string, len: return length of Fortran .len(3F) 

len: return length of Fortran string.len(3F) 
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Permuted Index 


getopt: get option letter from argument vector.getopt(3C) 

simple lexical tasks, lex: generate programs for.lex(l) 

generate programs for simple lexical tasks, lex: .lex(l) 

to subroutines and libraries, /introduction .intro(3) 

relation for an object library, /find ordering.lorder(l) 

ar: archive and library maintainer.ar.pdp(l) 

portable/ar: archive and library maintainer for.ar(l) 

ulimit: get and set user limits.ulimit(2) 

tn4: eight line asynchronous interface.tn4(7) 

tn74: two line asynchronous interface.tn74(7) 

an out-going terminal line connection, /establish.dial(3C) 

type, modes, speed, and line discipline./set terminal .getty(lM) 

wait on synchronous login line for use. stgetty: .stgetty(lM) 

du: DU-11 synchronous line interface.du(7) 

line: read one line.line(l) 

common object file, linenum: line number entries in a.linenum(4) 

/Idlinit, Idlitem: manipulate line number entries of a/.ldlread(3X) 

ldlseek,ldnlseek: seek to line number entries of a/.ldlseek(3X) 

strip: strip symbol and line number information from a/ .strip(l) 

nl: line numbering filter.nl(l) 

out selected fields of each line of a file, cut: cut.cut(l) 

tn85: medium speed line printer controller.tn85(7) 

Ipd: HONEYWELL sending daemon, line printer daemon, dpd, .dpd(lC) 

send/cancel requests to an LP line printer. Ip, cancel: .lp(l) 

Ip: line printer.lp(7) 

Ipr: line printer spooler.Ipr(l) 

line: read one line.line(l) 

Isearch: linear search and update.lsearch(3C) 

col: filter reverse line-feeds.col(l) 

in a common object file, linenum: line number entries.linenum(4) 

connect ACUs and communication lines, acuset:.acuset(lM) 

files, comm: select or reject lines common to two sorted .comm(l) 

uniq: report repeated lines in a file.uniq(l) 

of several files or subsequent lines of one file./same lines.paste(l) 

subsequent/paste: merge same lines of several files or .paste(l) 

vpmtest: test KMC lines.vpmtest(lM) 

link, unlink: exercise link and unlink system calls.link(lM) 

files. Id: link editor for common object .ld(l) 

Id: link editor.Id.pdp(l) 

a.out: common assembler and link editor output.a.out(4) 

a.out: PDP-11 assembler and link editor output.a.out.pdp(4) 

pci: parallel communications link interface.pcl(7) 

link: link to a file.link(2) 

pcldaemon: PCL link monitor.pcldaemon(lM) 

cp. In, mv: copy, link or move files.cp(l) 

link: link to a file.link(2) 

and unlink system calls, link, unlink: exercise link.link(lM) 

protocol, dmc: communications link with built-in DDCMP.dmc(7) 

attach or install a BX.25 link. x25alnk, x25ilnk:.x25alnk(3C) 

x25clnk: change over a BX.25 link.x25clnk(3C) 

halt or detach a BX.25 link. x25hlnk, x25dlnk:.x25hlnk(3C) 

install or remove a PVC on a link. x25ipvc, x25rpvc:.x25ipvc(3C) 

for a BX.25 minor device or link./remove, or get status.x25pvc(lM) 

lint: a C program checker.lint(l) 

Is: list contents of directories.ls(l) 

for a file system, ff: list file names and statistics .ff(lM) 

nlist: get entries from name list.nlist(3C) 

nm: print name list.nm.pdp(l) 

nm: print name list of common object file.nm(l) 

by fsck. checklist: list of file systems processed.checklist(4) 

from 3B20S object file, list: produce C source listing.list(l) 

file, list: produce C source listing from 3B20S object.list(l) 

xargs: construct argument list(s) and execute command.xargs(l) 

files, cp. In, mv: copy, link or move.cp(l) 

script, emulload: load and start 3270 emulation.emulload(lM) 

procedures. Idtape: load disk from tape.ldtape(8) 

Iboot. newboot: load VTOC, prom patch, or .newboot(lM) 

romboot: special ROM bootstrap loaders.romboot(8) 

tzset: convert date/ ctime, localtime, gmtime, asctime, .ctime(3C) 

index: return location of Fortran substring.index(3F) 

end, etext, edata: last locations in program.end(3C) 

memory, plock: lock process, text, or data in .plock(2) 
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Permuted Index 


trouble: log a trouble report.trouble(l) 

natural logarithm intrinsic/ log, alog, dlog, clog: Fortran.log(3F) 

gamma: log gamma function.gamma(3M) 

newgrp: log in to a new group.newgrp(l) 

exponential, logarithm,/exp, log, loglO, pow, sqrt:.exp(3M) 

common logarithm intrinsic/ loglO, aloglO, dloglO: Fortran.loglO(3F) 

logarithm, power,/exp, log, loglO, pow, sqrt: exponential, .exp(3M) 

/aloglO, dloglO: Fortran common logarithm intrinsic function.loglO(3F) 

/dlog, clog: Fortran natural logarithm intrinsic function.log(3F) 

/loglO, pow, sqrt: exponential, logarithm, power, square root/ .exp(3M) 

errpt: process a report of logged errors.errpt(lM) 

/disp: device logically on, logically off or display/.don(lM) 

don, doff, disp: device logically on, logically off or/.don(lM) 

stgetty: wait on synchronous login line for use.stgetty(lM) 

getlogin: get login name.getlogin(3C) 

logname: get login name.logname(l) 

cuserid: get character login name of the user.cuserid(3S) 

logname: return login name of user.logname(3X) 

passwd: change login password.passwd(l) 

login: sign on.login(l) 

setting up an environment at login time, profile:.profile(4) 

logname: get login name.logname(l) 

user, logname: return login name of .logname(3X) 

a641,164a: convert between long integer and base-64 ASCII/ .a641(3C) 

between 3-byte integers and long integers. /Itol3: convert.13tol(3C) 

sputl, sgetl: access long numeric data in a machine/.sputl(3X) 

setjmp, longjmp: non-local goto.setjmp(3C) 

perform the NSC local network loopback functions, nscloop:.nscloop(lM) 

for an object library, lorder: find ordering relation.lorder(l) 

nice: run a command at low priority.nice(l) 

requests to an LP line/ Ip, cancel: send/cancel .lp(l) 

send/cancel requests to an LP line printer. Ip, cancel:.lp(l) 

Ip: line printer.lp(7) 

disable: enable/disable LP printers, enable, .enable(l) 

/Ipshut, Ipmove: start/stop the LP request scheduler and move/.Ipsched(lM) 

accept, reject: allow/prevent LP requests.accept(lM) 

Ipadmin: configure the LP spooling system.Ipadmin(lM) 

Ipstat: print LP status information.Ipstat(l) 

spooling system. Ipadmin: configure the LP.Ipadmin(lM) 

line printer daemon, dpd, Ipd: HONEYWELL sending daemon, .dpd(lC) 

request/Ipsched, Ipshut, Ipmove: start/stop the LP .Ipsched(lM) 

Ipr: line printer spooler.Ipr(l) 

start/stop the LP request/ Ipsched, Ipshut, Ipmove:.Ipsched(lM) 

LP request scheduler/Ipsched, Ipshut, Ipmove: start/stop the.Ipsched(lM) 

information. Ipstat: print LP status.Ipstat(l) 

jrand48,/ drand48, erand48, lrand48, nrand48, mrand48, .drand48(3C) 

directories. Is: list contents of .ls(l) 

update. Isearch: linear search and .lsearch(3C) 

pointer. Iseek: move read/write file.lseek(2) 

bitwise/ and, or, xor, not, Ishift, rshift: Fortran .bool(3F) 

vlx: VAX-11/780 LSI console floppy interface.vlx(lM) 

integers and long/ 13tol, ItoB: convert between 3-byte.13tol(3C) 

m4: macro processor.m4(l) 

/access long numeric data in a machine independent fashion.sputl(3X) 

vpm: Virtual Protocol Machine.vpm(7) 

for the virtual protocol machine, vpmc: compiler.vpmc.dec(lM) 

for the virtual protocol machine, vpmc: compiler.vpmc.u3b(lM) 

permuted index, mptx: the macro package for formatting a.mptx(5) 

documents, mm: the MM macro package for formatting.mm(5) 

mosd: the OSDD adapter macro package for formatting/ .mosd(5) 

view graphs and/mv: a troff macro package for typesetting .mv(5) 

m4: macro processor.m4(l) 

in this manual, man: macros for formatting entries.man(5) 

formatted with the MM macros./print/check documents.mm(l) 

program, tapeboot: magnetic tape bootstrap.tapeboot(8) 

ht: TU16/TE16 magnetic tape interface.ht(7) 

tm:TMll/TU10 magnetic tape interface.tm(7) 

ts:TSll magnetic tape interface.tsll(7) 

tu78: TU78 magnetic tape interface.tu78(7) 

un32: magnetic tape interface.un32(7) 

un52: magnetic tape interface.un52(7) 

send mail to users or read mail, mail, rmail: .mail(l) 
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Permuted Index 


users or read mail, mail, rmail: send mail to.mail(l) 

gcosmail: send mail to HIS user.gcosmail(lC) 

mail, rmail: send mail to users or read mail.mail(l) 

malloc, free, realloc, calloc: main memory allocator.malloc(3C) 

regenerate groups of/make: maintain, update, and.make(l) 

ar: archive and library maintainer.ar.pdp(l) 

ar: archive and library maintainer for portable/.ar(l) 

intro: introduction to system maintenance commands and/.intro(lM) 

intro: introduction to system maintenance procedures.intro(8) 

sees file, delta: make a delta (change) to an .delta(l) 

mkdir: make a directory.mkdir(l) 

or ordinary file, mknod: make a directory, or a special.mknod(2) 

mktemp: make a unique file name.mktemp(3e) 

regenerate groups of/ make: maintain, update, and.make(l) 

banner: make posters.banner(l) 

key. makekey: generate encryption .makekey(l) 

main memory allocator, malloc, free, realloc, calloc: .malloc(3C) 

entries in this manual, man: macros for formatting .man(5) 

this manual, man, manprog: print entries in .man(l) 

tsearch, tdelete, twalk: manage binary search trees.tsearch(3C) 

hsearch, hcreate, hdestroy: manage hash search tables.hsearch(3C) 

records, fwtmp, wtmpfix: manipulate connect accounting.fwtmp(lM) 

of/ Idlread, Idlinit, Idlitem: manipulate line number entries.ldlread(3X) 

frexp, Idexp, modf: manipulate parts of/ .frexp(3C) 

manual, man, manprog: print entries in this.man(l) 

manprog: print entries in this manual, man,.man(l) 

for formatting entries in this manual, man: macros.man(5) 

change the diagnostic spooler map file, chmap:.chmap(lM) 

ascii: map of ASCII character set.ascii(5) 

files, diffmk: mark differences between.diffmk(l) 

umask: set file-creation mode mask.umask(l) 

set and get file creation mask, umask:.umask(2) 

table, master: master device information.master.dec(4) 

table, master: master device information.master.u3b(4) 

information table, master: master device.master.dec(4) 

information table, master: master device.master.u3b(4) 

regular expression compile and match routines, regexp:.regexp(5) 

eqn, neqn, checkeq: format mathematical text for nroff or/ .eqn(l) 

function, matherr: error-handling.matherr(3M) 

multiple-access-user-space/ maus:.maus(2) 

dmaxl: Fortran maximum-value/ max, maxO, amaxO, maxi, amaxl,.max(3F) 

dmaxl: Fortran/max, maxO, amaxO, maxi, amaxl,.max(3F) 

max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran/.max(3F) 

/maxi, amaxl, dmaxl: Fortran maximum-value functions.max(3F) 

maze: generate a maze.maze(6) 

maze: generate a maze.maze(6) 

accounting, mclock: return Fortran time .mclock(3F) 

rp07: RP07 non-removable medium moving-head disk.rp07(7) 

controller. tn85: medium speed line printer.tn85(7) 

mem, kmem: core memory.mem(7) 

memepy, memset: memory/ memcepy, memchr, mememp, .memory(3C) 

memset: memory/ memcepy, memchr, mememp, memepy,.memory(3C) 

operations, memcepy, memchr, mememp, memepy, memset: memory .memory(3C) 

memcepy, memchr, mememp, memepy, memset: memory/ .memory(3C) 

free, realloc, calloc: main memory allocator, malloc,.malloc(3C) 

shmctl: shared memory control operations.shmctl(2) 

queue, semaphore set or shared memory id./remove a message.ipcrm(l) 

mem, kmem: core memory.mem(7) 

/(shared memory) operations.maus(2) 

mememp, memepy, memset: memory operations, /memchr, .memory(3C) 

shmop: shared memory operations.shmop(2) 

lock process, text, or data in memory, plock:.plock(2) 

shmget: get shared memory segment.shmget(2) 

interface, msi: memory system diagnostic.msi(lM) 

/memchr, mememp, memepy, memset: memory operations.memory(3C) 

sort: sort and/or merge files.sort(l) 

files, acetmerg: merge or add total accounting .acctmerg(lM) 

files or subsequent/paste: merge same lines of several .paste(l) 

mesg: permit or deny messages.mesg(l) 

msgctl: message control operations.msgctl(2) 

msgop: message operations.msgop(2) 

prm: send a Processor Recovery Message.prm(lM) 
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Permuted Index 


msgget: get message queue.msgget(2) 

or shared/ipcrm: remove a message queue, semaphore set .ipcrm(l) 

mesg: permit or deny messages.mesg(l) 

osm: interface to UNIX system messages.osm(7) 

sys nerr: system error messages./errno, sys_errlist,.perTor(3C) 

prm: 3B20S Processor Recovery Messages.prm(8) 

/for the KMC 11B microprocessor.kasb( 1) 

kmc: KMC-llB/KMSll microprocessor.kmc(7) 

dminl: Fortran minimum-value/ min, minO, aminO, mini, aminl, .min(3F) 

dminl: Fortran/min, minO, aminO, mini, aminl,.min(3F) 

min, minO, aminO, mini, aminl, dminl: Fortran/.min(3F) 

/mini, aminl, dminl: Fortran minimum-value functions.min(3F) 

or get status for a BX.25 minor device or link./remove,.x25pvc(lM) 

and commands, mk: how to remake the system.mk(8) 

boot image, mkboot: convert a.out file to.mkboot(lM) 

mkdir: make a directory.mkdir(l) 

mkfs: construct a file system.mkfs(lM) 

mknod: build special file.mknod(lM) 

special or ordinary file, mknod: make a directory, or a .mknod(2) 

name, mktemp: make a unique file .mktemp(3C) 

mllFMLll solid-state disk.mlll(7) 

mill: MLll solid-state disk.mlll(7) 

formatting documents, mm: the MM macro package for.mm(5) 

documents formatted with the MM macros./print/check.mm(l) 

documents formatted with the/ mm, osdd, checkmm: print/check.mm(l) 

formatting documents, mm: the MM macro package for .mm(5) 

view graphs, and slides, mmt, mvt: typeset documents, .mmt(l) 

table, mnttab: mounted file system.mnttab(4) 

remaindering intrinsic/ mod, amod, dmod: Fortran.mod(3F) 

chmod: change mode.chmod(l) 

umask: set file-creation mode mask.umask(l) 

chmod: change mode of file.chmod(2) 

dmk:DMll-BA modem control multiplexor.dmk(7) 

getty: set terminal type, modes, speed, and line/.getty(lM) 

bs: a compiler/interpreter for modest-sized programs.bs(l) 

floating-point/ frexp, Idexp, modf: manipulate parts of.frexp(3C) 

touch: update access and modification times of a file.touch/1) 

utime: set file access and modification times.utime(2) 

ssr, setssr, clrssr: print or modify the System Status/.ssr(lM) 

/ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp,/ .acctsh(lM) 

pcldaemon: PCL link monitor.pcldaemon(lM) 

profile, monitor: prepare execution.monitor(3C) 

uusub: monitor uucp network.uusub(lM) 

moo: guessing game.moo(6) 

package for formatting/ mosd: the OSDD adapter macro.mosd(5) 

mount: mount a file system.mount(2) 

system, mount, umount: mount and dismount file.mount(lM) 

mount: mount a file system.mount(2) 

setmnt: establish mount table.setmnt(lM) 

dismount file system, mount, umount: mount and .mount(lM) 

mnttab: mounted file system table.mnttab(4) 

mvdir: move a directory.mvdir(lM) 

cp. In, mv: copy, link or movefiles.cp(l) 

Iseek: move read/write file pointer.lseek(2) 

the LP request scheduler and move requests./start/stop.Ipsched(lM) 

dsk: 3B20S moving-head disk.dsk(7) 

hm: RM05 moving-head disk.hm(7) 

hp: RP04/RP05/RP06 moving-head disk.hp(7) 

rmSO: RM80 moving-head disk.rm80(7) 

RP07 non-removable medium moving-head disk. rp07: .rp07(7) 

rp: RP-11/RP03 moving-head disk.rp(7) 

gd: general driver for moving-head disks.gd(7) 

formatting a permuted index, mptx: the macro package for.mptx(5) 

/erand48, lrand48, nrand48, mrand48, jrand48, srand48,/.drand48(3C) 

setmrf: override system MRF action.setmrf(lM) 

operations, msgctl: message control.msgctl(2) 

msgget: get message queue.msgget(2) 

msgop: message operations.msgop(2) 

interface, msi: memory system diagnostic.msi(lM) 

(shared memory)/ mans: multiple-access-user-space.maus(2) 

DH-11 asynchronous multiplexers. /DZ-11/KMC-l IB,.dz(7) 

dmk: DM11-BA modem control multiplexor.dmk(7) 
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Permuted Index 


typesetting view graphs and/ 
cp, In, 

graphs, and slides, mmt, 
log, alog, dlog, clog: Fortran 

i-numbers. 
/dnint, nint, idnint: Fortran 
mathematical text for/ eqn, 
definitions for eqn and 
PCL network. 

nc: 

x25: BX.25 
nscloop: perform the NSC local 
execute a command on the PCL 
control the NSC local 
operation status of the NSC 
to another UNIX on the NSC 
re-route jobs from the NSC 
commands, stat: statistical 
uusub: monitor uucp 
patch, or Iboot. 
a text file. 

news: print 

process, 
priority, 
integer/ anint, dnint, 

list. 

object file, 
hangups and quits, 
setjmp, longjmp: 
moving-head/ rp07: RP07 
bitwise boolean/ and, or, xor, 
drand48, erand48, lrand48, 

format mathematical text for 
tbl: format tables for 
constructs, deroff: remove 
specification, nsc: 
nscloop: perform the 
operationally control the 
the operation status of the 
files to another UNIX on the 
re-route jobs from the 
specification, 
network loopback functions, 
the NSC local network, 
status of the NSC network, 
the NSC network to RJE. 

null: the 

/dodisk, lastlogin, monacct, 
nl: line 

sputl, sgetl: access long 
graphics: access graphical and 
UNIX on the NSC network, 
common/ convert: convert 
Idfcn: common 
cprs: compress an IS25 
dump selected parts of an 
Idopen, Idaopen: open a common 
number entries of a common 
Idaclose: close a common 
the file header of a common 
of a section of a common 
file header of a common 
of a section of a common 
section header of a common 


mv: a troff macro package for .mv(5) 

mv: copy, link or move files.cp(l) 

mvdir: move a directory.mvdir(lM) 

mvt: typeset documents, view .mmt(l) 

natural logarithm intrinsic/.log(3F) 

nc: network control.nc(7) 

ncheck: generate names from.ncheck(lM) 

nearest integer functions.round(3F) 

neqn, checkeq: format .eqn(l) 

neqn. /special character.eqnchar(5) 

net: execute a command on the.net(lC) 

network control.nc(7) 

network interface.x25(7) 

network loopback functions.nscloop(lM) 

network, net:.net(lC) 

network, /operationally.nscmon(lM) 

network, nscstat: query the .nscstat(lC) 

network, nusend: send files .nusend(lC) 

network to RJE. nsctorje:.nsctorje(lC) 

network useful with graphical .stat(lG) 

network.uusub(lM) 

newboot: load VTOC, prom.newboot(lM) 

newform: change the format of.newform(l) 

newgrp: log in to a new group.newgrp(l) 

news items.news(l) 

news: print news items.news(l) 

nice: change priority of a .nice(2) 

nice: run a command at low .nice(l) 

nint, idnint: Eortran nearest .round(3F) 

nl: line numbering filter.nl(l) 

nlist: get entries from name .nlist(3C) 

nm: print name list.nm.pdp( 1) 

nm: print name list of common.nm(l) 

nohup: run a command immune to.nohup(l) 

non-local goto.setjmp(3C) 

non-removable medium.rp07(7) 

not, Ishift, rshift: Fortran .bool(3F) 

nrand48, mrand48, jrand48,/.drand48(3C) 

nroff: format text.nroff(l) 

nroff or troff./checkeq:.eqn(l) 

nroff or troff.tbl( 1) 

nroff/troff, tbl, and eqn .deroff(l) 

NSC adapter interface.nsc(7) 

NSC local network loopback/.nscloop(lM) 

NSC local network, nscmon:.nscmon(lM) 

NSC network, nscstat: query.nscstat(lC) 

NSC network, nusend: send.nusend(lC) 

NSC network to RJE. nsctorje:.nsctorje(lC) 

nsc: NSC adapter interface.nsc(7) 

nscloop: perform the NSC local.nscloop(lM) 

nscmon: operationally control .nscmon(lM) 

nscstat: query the operation .nscstat(lC) 

nsctorje: re-route jobs from .nsctorje(lC) 

null file.null(7) 

null: the null file.null(7) 

nulladm, prctmp, prdaily,/.acctsh(lM) 

numbering filter.nl(l) 

numeric data in a machine/.sputl(3X) 

numerical commands.graphics(lG) 

nusend: send files to another.nusend(lC) 

object and archive files to.convert(l) 

object file access routines.ldfcn(4) 

object file.cprs(l) 

object file, dump: .dump(l) 

object file for reading.ldopen(3X) 

object file function, /line .ldlread(3X) 

object file. Idclose,.ldclose(3X) 

object file. Idfhread: read .ldfhread(3X) 

object file, /number entries.ldlseek(3X) 

object file, /to the optional.ldohseek(3X) 

object file, /entries.ldrseek(3X) 

object file, /indexed/named .ldshread(3X) 
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Permuted Index 


section of a common object file, /indexed/named .ldsseek(3X) 

symbol table entry of a common object file./the index of a.ldtbindex(3X) 

symbol table entry of a common object file./read an indexed .ldtbread(3X) 

the symbol table of a common object file./seek to.ldtbseek(3X) 

number entries in a common object file, linenum: line .linenum(4) 

C source listing from 3B20S object file, list: produce.list(l) 

nm: print name list of common object file.nm(l) 

information for a common object file./relocation .reloc(4) 

section header for a common object file, scnhdr:.scnhdr(4) 

information from a common object file./and line number.strip(l) 

format, syms: common object file symbol table.syms(4) 

file header for common object files, filehdr: .filehdr(4) 

Id: link editor for common object files.ld(l) 

print section sizes of common object files, size:.size(l) 

size: print sizes of object files.size.pdp(l) 

find ordering relation for an object library, lorder:.lorder(l) 

sky: obtain ephemerides.sky(6) 

od: octal dump.od(l) 

od: octal dump.od(l) 

dpr: off-line print.dpr(lC) 

/doff, disp: device logically on, logically off or display/ .don(lM) 

dgn: on-line diagnostic interface.dgn(7) 

sta: find status of pending on-line diagnostic requests.sta(lM) 

abt: abort on-line diagnostics.abt(lM) 

dgn: initiate on-line diagnostics.dgn(lM) 

start, stop and find status of on-line diagnostics./dstat:.dstart(lM) 

unit from service before on-line diagnostics./remove.rmv(lM) 

restore unit to service after on-line diagnostics, rst:.rst(lM) 

reading. Idopen, Idaopen: open a common object file for .ldopen(3X) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

dup: duplicate an open file descriptor.dup(2) 

open: open for reading or writing.open(2) 

writing, open: open for reading or .open(2) 

prf: operating system profiler.prf(7) 

/prfdc, prfsnap, prfpr: operating system profiler.profiler(lM) 

network, nscstat: query the operation status of the NSC .nscstat(lC) 

local network, nscmon: operationally control the NSC .nscmon(lM) 

3B20ops: 3B20S console operations.3B20ops(8) 

750ops: VAX-11/750 console operations. 750ops(8) 

780ops: VAX-11/780 console operations. 780ops(8) 

/(shared memory) operations.maus(2) 

memcmp, memcpy, memset: memory operations, memccpy, memchr,.memory(3C) 

msgctl: message control operations.msgctl(2) 

msgop: message operations.msgop(2) 

semctl: semaphore control operations.semctl(2) 

semop: semaphore operations.semop(2) 

shmctl: shared memory control operations.shmctl(2) 

shmop: shared memory operations.shmop(2) 

strcspn, strtok: string operations, /strpbrk, strspn, .string(3C) 

join: relational database operator.join(l) 

dcopy: copy file systems for optimal access time.dcopy(lM) 

vector, getopt: get option letter from argument .getopt(3C) 

common/ Idohseek: seek to the optional file header of a.ldohseek(3X) 

fcntl: file control options.fcntl(5) 

stty:setthe options for a terminal.stty(l) 

getopt: parse command options.getopt(l) 

Fortran bitwise boolean/ and, or, xor, not, Ishift, rshift:.bool(3F) 

object library, lorder: find ordering relation for an.lorder(l) 

a directory, or a special or ordinary file, mknod: make .mknod(2) 

formatting/mosd: the OSDD adapter macro package for.mosd(5) 

documents formatted with/mm, osdd, checkmm: print/check.mm(l) 

messages, osm: interface to UNIX system.osm(7) 

dial: establish an out-going terminal line/.dial(3C) 

assembler and link editor output, a.out: common.a.out(4) 

assembler and link editor output, a.out: PDP-11 .a.out.pdp(4) 

sprintf: print formatted output, printf, fprintf,.printf(3S) 

gcat: send phototypesetter output to the HONEYWELL 6000.gcat(lC) 

setmrf: override system MRF action.setmrf(lM) 

/acctdusg, accton, acctwtmp: overview of accounting and/.acct(lM) 

chown: change owner and group of a file.chown(2) 

chown, chgrp: change owner or group.chown(l) 

and expand files, pack, peat, unpack: compress.pack(l) 
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Permuted Index 


permuted/mptx: the macro package for formatting a.mptx(5) 

documents, mm: the MM macro package for formatting .mm(5) 

mosd: the OSDD adapter macro package for formatting/.mosd(5) 

graphs and/ mv: a troff macro package for typesetting view.mv(5) 

sadc: system activity report package, sal, sa2,.sar(lM) 

standard buffered input/output package, stdio: .stdio(3S) 

interprocess communication package, stdipc: standard.stdipc(3C) 

dskvfy: format and verify disk packs, dskfmt, .dskfmt(lM) 

check RP06 and RM05 disk packs, format: format and/or.format(lM) 

4014 terminal. 4014: paginator for the Tektronix.4014(1) 

interface, pci: parallel communications link.pcl(7) 

ipb: read the EAI Input Parameter Buffer.ipb(lM) 

process, process group, and parent process IDs. /get.getpid(2) 

getopt: parse command options.getopt(l) 

passwd: change login password.passwd(l) 

passwd: password file.passwd(4) 

/setpwent, endpwent: get password file entry.getpwent(3C) 

putpwent: write password file entry.putpwent(3C) 

passwd: password file.passwd(4) 

getpass: read a password.getpass(3C) 

passwd: change login password.passwd(l) 

pwck, grpck: password/group file checkers.pwck(lM) 

several files or subsequent/ paste: merge same lines of.paste(l) 

newboot: load VTOC, prom patch, or Iboot.newboot(lM) 

dimame: deliver portions of path names, basename,.basename(l) 

directory, getcwd: get path-name of current working .getcwd(3C) 

fgrep: search a file for a pattern, grep, egrep, .grep(l) 

processing language, awk: pattern scanning and.awk(l) 

signal, pause: suspend process until.pause(2) 

expand files, pack, peat, unpack: compress and .pack(l) 

cc, pcc: C compiler.cc(l) 

pcldaemon: PCL link monitor.pcldaemon(lM) 

net: execute a command on the PCL network.net(lC) 

link interface, pci: parallel communications.pcl(7) 

pcldaemon: PCL link monitor.pcldaemon(lM) 

a process, popen, pclose: initiate pipe to/from .popen(3S) 

fsev: convert files between PDP-11 and VAX-11/780 systems.fscv(lM) 

as: assembler for PDP-11.as.pdp(l) 

editor output, a.out: PDP-11 assembler and link .a.out.pdp(4) 

/convert archive files from PDP-11 to common archive/.arcv(l) 

truth value about your/ pdpl 1, u3b, u3b5, vax: provide.machid(l) 

requests, sta: find status of pending on-line diagnostic.sta(lM) 

functions, emulcntrl: perform 3270 emulation control.emulcntrl(lM) 

loopback functions, nscloop: perform the NSC local network.nscloop(lM) 

mesg: permit or deny messages.mesg(l) 

macro package for formatting a permuted index, mptx: the.mptx(5) 

ptx: permuted index.ptx(l) 

format, acet: per-process accounting file.acct(4) 

acetems: command summary from per-process accounting/.acctcms(lM) 

sys nerr: system error/ perror, ermo, sys errlist,.perror(3C) 

cat: phototypesetter interface.cat(7) 

HONEYWELL 6000. gcat: send phototypesetter output to the.gcat(lC) 

tc: phototypesetter simulator.tc(l) 

split: split a file into pieces.split(l) 

channel, pipe: create an interprocess.pipe(2) 

tee: pipe fitting.tee(l) 

popen, pclose: initiate pipe to/from a process.popen(3S) 

data in memory, plock: lock process, text, or .plock(2) 

plot: graphics interface.plot(4) 

subroutines, plot: graphics interface .plot(3X) 

images, pnch: file format for card .pnch(4) 

ftell: reposition a file pointer in a stream, /rewind,.fseek(3S) 

Iseek: move read/write file pointer.lseek(2) 

to/from a process, popen, pclose: initiate pipe.popen(3S) 

and library maintainer for portable archives./archive.ar(l) 

basename, dirname: deliver portions of path names.basename(l) 

banner: make posters.banner(l) 

logarithm,/ exp, log, loglO, pow, sqrt: exponential, .exp(3M) 

/sqrt: exponential, logarithm, power, square root functions.exp(3M) 

bre, bcheckrc, rc, powerfail: system/.brc(lM) 

pr: print files.pr(l) 

/lastlogin, monacct, nulladm, pretmp, prdaily, prtacct,/ .acctsh(lM) 
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/monacct, nulladm, prctmp, prdaily, prtacct, runacct,/ .acctsh(lM) 

for troff. cw, checkcw: prepare constant-width text .cw(l) 

monitor: prepare execution profile.monitor(3C) 

cpp: the C language preprocessor.cpp(l) 

unget: undo a previous get of an SCCS file.unget(l) 

profiler, prf: operating system.prf(7) 

operating/prfld, prfstat, prfdc, prfsnap, prfpr:.profiler(lM) 

prfsnap, prfpr: operating/ prfld, prfstat, prfdc,.profiler(lM) 

/prfstat, prfdc, prfsnap, prfpr: operating system/.profiler(lM) 

system/prfld, prfstat, prfdc, prfsnap, prfpr: operating.profiler(lM) 

prfpr: operating/prfld, prfstat, prfdc, prfsnap, .profiler(lM) 

graphical/ gps: graphical primitive string, format of.gps(4) 

types: primitive system data types.types(5) 

prs: print an SCCS file.prs(l) 

date: print and set the date.date(l) 

cal: print calendar.cal(l) 

of a file, sum: print checksum and block count.sum(l) 

editing activity, sact: print current SCCS file .sact(l) 

dpr: off-line print.dpr(lC) 

man, manprog: print entries in this manual.man(l) 

cat: concatenate and print files.cat(l) 

scat: concatenate and print files on synchronous/.scat(l) 

pr: print files.pr(l) 

printf, fprintf, sprintf: print formatted output.printf(3S) 

Ipstat: print LP status information.Ipstat(l) 

nm: print name list.nm.pdp(l) 

object file, nm: print name list of common.nm(l) 

system, uname: print name of current UNIX .uname(l) 

news: print news items.news(l) 

Status/ssr, setssr, clrssr: print or modify the System.ssr(lM) 

file(s). acctcom: search and print process accounting.acctcom(l) 

object files, size: print section sizes of common .size(l) 

size: print sizes of object files.size.pdp(l) 

names, id: print user and group IDs and.id(l) 

vpmsave, vpmfmt: save and print VPM event traces.vpmsave(lM) 

formatted/mm, osdd, checkmm: print/check documents .mm(l) 

tn85: medium speed line printer controller.tn85(7) 

HONEYWELL sending daemon, line printer daemon, dpd, Ipd:.dpd(lC) 

requests to an LP line printer./cancel: send/cancel.lp(l) 

Ip: line printer.lp(7) 

and print files on synchronous printer, scat: concatenate .scat(l) 

Ipr: line printer spooler.Ipr(l) 

vpr: Versatec printer spooler.vpr(l) 

vp: Versatec printer.vp(7) 

disable: enable/disable LP printers, enable,.enable(l) 

print formatted output, printf, fprintf, sprintf:.printf(3S) 

nice: run a command at low priority.nice(l) 

nice: change priority of a process.nice(2) 

Messages, prm: 3B20S Processor Recovery .prm(8) 

Message, prm: send a Processor Recovery.prm(lM) 

errors, errpt: process a report of logged.errpt(lM) 

acct: enable or disable process accounting.acct(2) 

acctprcl, acctprc2: process accounting.acctprc(lM) 

acctcom: search and print process accounting file(s).acctcom(l) 

times, times: get process and child process .times(2) 

init, telinit: process control/.init(lM) 

timex: time a command; report process data and system/ .timex(l) 

exit, exit: terminate process.exit(2) 

fork: create a new process.fork(2) 

/getpgrp, getppid: get process, process group, and parent/.getpid(2) 

setpgrp: set process group ID.setpgrp(2) 

process group, and parent process IDs./get process,.getpid(2) 

inittab: script for the init process.inittab(4) 

kill: terminate a process.kill(l) 

nice: change priority of a process.nice(2) 

kill: send a signal to a process or a group of/.kill(2) 

initiate pipe to/from a process, popen, pclose:.popen(3S) 

getpid, getpgrp, getppid: get process, process group, and/.getpid(2) 

ps: report process status.ps(l) 

memory, plock: lock process, text, or data in.plock(2) 

times: get process and child process times.times(2) 

wait: wait for child process to stop or terminate.wait(2) 
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Permuted Index 


ptrace: process trace.ptrace(2) 

pause: suspend process until signal.pause(2) 

wait: await completion of process.wait(l) 

list of file systems processed by fsck. checklist:.checklist(4) 

to a process or a group of processes./send a signal .kill(2) 

killall: kill all active processes.killall(lM) 

structure, fuser: identify processes using a file or file .fuser(lM) 

awk: pattern scanning and processing language.awk(l) 

shutdown: terminate all processing.shutdown(lM) 

m4: macro processor.m4(l) 

prm:senda Processor Recovery Message.prm(lM) 

prm: 3B20S Processor Recovery Messages.prm(8) 

provide truth value about your processor type. /u3b5, vax: .machid(l) 

alarm: set a process’s alarm clock.alarm(2) 

3B20S object file, list: produce C source listing from .list(l) 

prof: display profile data.prof(l) 

profile, profil: execution time.profil(2) 

prof: display profile data.prof(l) 

monitor: prepare execution profile.monitor(3C) 

profil: execution time profile.profil(2) 

environment at login time, profile: setting up an.profile(4) 

prf: operating system profiler.prf(7) 

prfpr: operating system profiler./prfdc, prfsnap,.profiler(lM) 

sadp: disk access profiler.sadp(l) 

/connect/load VPM drivers and programmable communication/.vpmset(lM) 

standard/restricted command programming language./the.sh(l) 

newboot: load VTOC, prom patch, or Iboot.newboot(lM) 

link with built-in DDCMP protocol, dmc: communications.dmc(7) 

vpm: Virtual Protocol Machine.vpm(7) 

vpmc: compiler for the virtual protocol machine.vpmc.dec(lM) 

vpmc: compiler for the virtual protocol machine.vpmc.u3b(lM) 

arithmetic: provide drill in number facts.arithmetic(6) 

pdpl 1, u3b, u3b5, vax: provide truth value about your/.machid(l) 

true, false: provide truth values.true(l) 

prs: print an sees file.prs(l) 

/nulladm, pretmp, prdaily, prtacct, runacct, shutacct,/.acctsh(lM) 

ps: report process status.ps(l) 

/generate uniformly distributed pseudo-random numbers.drand48(3e) 

ptrace: process trace.ptrace(2) 

ptx: permuted index.ptx(l) 

stream, ungetc: push character back into input .ungetc(3S) 

put character or word on a/ putc, putchar, fputc, putw:.putc(3S) 

character or word on a/ putc, putchar, fputc, putw: put.putc(3S) 

entry, putpwent: write password file.putpwent(3e) 

stream, puts, fputs: put a string on a .puts(3S) 

getutent, getutid, getutline, pututline, setutent, endutent,/.getut(3e) 

a/ putc, putchar, fputc, putw: put character or word on.putc(3S) 

x25rpvc: install or remove a PVC on a link. x25ipvc,.x25ipvc(3C) 

file checkers, pwck, grpek: password/group.pwck(lM) 

pwd: working directory name.pwd(l) 

qsort: quicker sort.qsort(3C) 

the NSC network, nscstat: query the operation status of.nscstat(lC) 

msgget: get message queue.msgget(2) 

iperm: remove a message queue, semaphore set or shared/.ipcrm(l) 

qsort: quicker sort.qsort(3C) 

command immune to hangups and quits, nohup: run a.nohup(l) 

quiz: test your knowledge.quiz(6) 

random-number/ srand, rand: Fortran uniform.rand(3F) 

random-number generator, rand, srand: simple.rand(3C) 

rand, srand: simple random-number generator.rand(3C) 

srand, rand: Fortran uniform random-number generator.rand(3F) 

fsplit: split f77, ratfor, or efl files.fsplit(l) 

dialect, ratfor: rational Fortran .ratfor(l) 

ratfor: rational Fortran dialect.ratfor(l) 

initialization/bre, bcheckrc, rc, powerfail: system.brc(lM) 

getpass: read a password.getpass(3C) 

entry of a common/ Idtbread: read an indexed symbol table.ldtbread(3X) 

header/ Idshread, Idnshread: read an indexed/named section.ldshread(3X) 

read: read from file.read(2) 

rmail: send mail to users or read mail, mail,.mail(l) 

line: read one line.line(l) 

read: read from file.read(2) 
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Permuted Index 


member of an/ Idahread: read the archive header of a .ldahread(3X) 

Buffer, ipb: read the EAI Input Parameter.ipb(lM) 

common object file. Idfhread: read the file header of a.ldfhread(3X) 

open a common object file for reading. Idopen, Idaopen:.ldopen(3X) 

open: open for reading or writing.open(2) 

Iseek: move read/write file pointer.lseek(2) 

cmplx,/ int, ifix, idint, real, float, sngl, dble,.ftype(3F) 

allocator, malloc, free, realloc, calloc: main memory.malloc(3C) 

reboot: reboot the system.reboot(lM) 

reboot: reboot the system.reboot(lM) 

specify what to do upon receipt of a signal, signal:.signal(2) 

/specify Fortran action on receipt of a system signal.signal(3F) 

from per-process accounting records./command summary.acctcms(lM) 

errdead: extract error records from dump.errdead(lM) 

manipulate connect accounting records, fwtmp, wtmpfix:.fwtmp(lM) 

tape, free: recover files from a backup .frec(lM) 

prm: send a Processor Recovery Message.prm(lM) 

prm: 3B20S Processor Recovery Messages.prm(8) 

ed, red: text editor.ed(l) 

generate C program cross reference, cxref:.cxref(l) 

execute regular expression, regemp, regex: compile and .regcmp(3X) 

compile, regemp: regular expression.regcmp(l) 

make: maintain, update, and regenerate groups of programs.make(l) 

regular expression, regemp, regex: compile and execute .regcmp(3X) 

compile and match routines, regexp: regular expression.regexp(5) 

or modify the System Status Register./clrssr: print.ssr(lM) 

match routines, regexp: regular expression compile and.regexp(5) 

regemp: regular expression compile.regcmp(l) 

regex: compile and execute regular expression, regemp, .regcmp(3X) 

requests, accept, reject: allow/prevent FP.accept(lM) 

sorted files, comm: select or reject lines common to two.comm(l) 

lorder: find ordering relation for an object/.lorder(l) 

join: relational database operator.join(l) 

for a common object file, reloc: relocation information.reloc(4) 

strip: remove symbols and relocation bits.strip.pdp(l) 

Idrseek, Idnrseek: seek to relocation entries of a/ .ldrseek(3X) 

common object file, reloc: relocation information for a .reloc(4) 

/fmod, fabs: floor, ceiling, remainder, absolute value/.floor(3M) 

mod, amod, dmod: Fortran remaindering intrinsic/ .mod(3F) 

commands, mk: how to remake the system and .mk(8) 

calendar: reminder service.calendar(l) 

rje: RJF (Remote Job Entry) to IBM.rje(8) 

ct: spawn getty to a remote terminal.ct(lC) 

file, rmdel: remove a delta from an SCCS .rmdel(l) 

semaphore set or/iperm: remove a message queue, .ipcrm(l) 

x25ipvc, x25rpvc: install or remove a PVC on a link.x25ipvc(3C) 

unlink: remove directory entry.unlink(2) 

rm, rmdir: remove files or directories.rm(l) 

eqn constructs, deroff: remove nroff/troff, tbl, and.deroff(l) 

x25pvc, x251nk: install, remove, or get status for a/.x25pvc(lM) 

bits, strip: remove symbols and relocation.strip.pdp(l) 

before on-line/rmv: remove unit from service .rmv(lM) 

check and interactive repair, /system consistency .fsck(lM) 

uniq: report repeated lines in a file.uniq(l) 

console, rjestat: RJE status report and interactive status .rjestat(lC) 

clock: report CPU time used.clock(3C) 

communication/ipcs: report inter-process.ipcs(l) 

blocks, df: report number of free disk.df(lM) 

errpt: process a report of logged errors.errpt(lM) 

sa2, sadc: system activity report package, sal, .sar(lM) 

timex: time a command; report process data and system/.timex(l) 

ps: report process status.ps(l) 

file, uniq: report repeated lines in a.uniq(l) 

facilities status, ststat: report synchronous terminal.ststat(l) 

trouble: log a trouble report.trouble(l) 

sar: system activity reporter.sar(l) 

trouble: trouble reporting system.trouble(8) 

stream, fseek, rewind, ftell: reposition a file pointer in a .fseek(3S) 

/Ipmove: start/stop the FP request scheduler and move/.Ipsched(lM) 

reject: allow/prevent FP requests, accept,.accept(lM) 

FP request scheduler and move requests./start/stop the.Ipsched(lM) 

of pending on-line diagnostic requests, sta: find status.sta(lM) 
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Permuted Index 


Ip, cancel: send/cancel requests to an LP line/ .lp(l) 

network to RJE. nsctorje: re-route jobs from the NSC .nsctorje(lC) 

on-line diagnostics, rst: restore unit to service after.rst(lM) 

HONEYWELL/fget, fget.demon: retrieve files from the.fget(lC) 

argument, getarg: return Fortran command-line.getarg(3F) 

variable, getenv: return Fortran environment.getenv(3F) 

accounting, mclock: return Fortran time.mclock(3F) 

abs: return integer absolute value.abs(3C) 

string, len: return length of Fortran.len(3F) 

substring, index: return location of Fortran .index(3F) 

logname: return login name of user.logname(3X) 

name, getenv: return value for environment.getenv(3C) 

stat: data returned by stat system call.stat(5) 

reversi: a game of dramatic reversals.reversi(6) 

col: filter reverse line-feeds.col(l) 

reversals, reversi: a game of dramatic .reversi(6) 

file pointer in a/fseek, rewind, ftell: reposition a .fseek(3S) 

creat: create a new file or rewrite an existing one.creat(2) 

file, rf: RFll/RSll fixed-head disk.rf(7) 

file, rf: RFl 1/RSl 1 fixed-head disk .rf(7) 

disk file, hs: RHl 1/RJS03-RJS04 fixed-head.hs(7) 

gather files and/or submit RJE jobs, send, gath:.send(lC) 

jobs from the NSC network to RJE. nsctorje: re-route .nsctorje(lC) 

rje: RJE (Remote Job Entry) to IBM.rje(8) 

IBM. rje: RJE (Remote Job Entry) to.rje(8) 

interactive status/rjestat: RJE status report and.rjestat(lC) 

interactive status console, rjestat: RJE status report and.rjestat(lC) 

rk: RK-11/RK03 or RK05 disk.rk(7) 

rk:RK-ll/RK03or RK05 disk.rk(7) 

rk: RK-ll/RK03orRK05disk.rk(7) 

rl: RL-ll/RLOl disk.rl(7) 

rl: RL-ll/RLOl disk.rl(7) 

directories, rm, rmdir: remove files or.rm(l) 

format and/or check RP06 and RM05 disk packs, format:.format(lM) 

hm: RM05 moving-head disk.hm(7) 

rm80: RM80 moving-head disk.rm80(7) 

rm80: RM80 moving-head disk.rm80(7) 

read mail, mail, rmail: send mail to users or .mail(l) 

sees file, rmdel: remove a delta from an .rmdel(l) 

directories, rm, rmdir: remove files or.rm(l) 

before on-line diagnostics, rmv: remove unit from service .rmv(lM) 

romboot: special ROM bootstrap loaders.romboot(8) 

loaders, romboot: special ROM bootstrap .romboot(8) 

chroot: change root directory.chroot(2) 

chroot: change root directory for a command.chroot(lM) 

logarithm, power, square root functions, /exponential,.exp(3M) 

/dsqrt, csqrt: Fortran square root intrinsic function.sqrt(3F) 

/tekset, td: graphical device routines and filters.gdev(lG) 

common object file access routines. Idfcn: .ldfcn(4) 

expression compile and match routines, regexp: regular .regexp(5) 

graphical table of contents routines, toe:.toc(lG) 

disk, rp: RP-11/RP03 moving-head .rp(7) 

moving-head disk, hp: RP04/RP05/RP06.hp(7) 

format: format and/or check RP06 and RM05 disk packs.format(lM) 

moving-head disk. rp07: RP07 non-removable medium .rp07(7) 

medium moving-head disk. rp07: RP07 non-removable .rp07(7) 

rp: RP-11/RP03 moving-head disk.rp(7) 

standard/restricted/ sh, rsh: shell, the.sh(l) 

and, or, xor, not, Ishift, rshift: Fortran bitwise/ .bool(3F) 

after on-line diagnostics, rst: restore unit to service .rst(lM) 

nice: run a command at low priority.nice(l) 

hangups and quits, nohup: run a command immune to.nohup(l) 

runacct: run daily accounting.runacct(lM) 

runacct: run daily accounting.runacct(lM) 

/pretmp, prdaily, prtacct, runacct, shutacct, startup,/.acctsh(lM) 

activity report package, sal, sa2, sadc: system.sar(lM) 

report package, sal, sa2, sadc: system activity .sar(lM) 

editing activity, sact: print current SCCS file.sact(l) 

package, sal, sa2, sadc: system activity report .sar(lM) 

sadp: disk access profiler.sadp(l) 

sag: system activity graph.sag(lG) 

sar: system activity reporter.sar(l) 
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Permuted Index 


traces, vpmsave, vpmfmt: save and print VPM event.vpmsave(lM) 

space allocation, brk, sbrk: change data segment.brk(2) 

formatted input, scanf, fscanf, sscanf: convert.scanf(3S) 

bfs: big file scanner.bfs(l) 

language, awk: pattern scanning and processing.awk(l) 

files on synchronous printer, scat: concatenate and print.scat(l) 

stand-alone programs, see: C compiler for.scc(l) 

the delta commentary of an SCCS delta, ede: change .cdc(l) 

comb: combine SCCS deltas.comb(l) 

make a delta (change) to an SCCS file, delta: .delta(l) 

sact: print current SCCS file editing activity.sact(l) 

get: get a version of an SCCS file.get(l) 

prs: print an SCCS file.prs(l) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

compare two versions of an SCCS file, scesdiff: .sccsdiff(l) 

scesfile: format of SCCS file.sccsfile(4) 

undo a previous get of an SCCS file, unget: .unget(l) 

val: validate SCCS file.val(l) 

admin: create and administer SCCS files.admin(l) 

what: identify SCCS files.what(l) 

of an SCCS file, scesdiff: compare two versions.sccsdiff(l) 

scesfile: format of SCCS file.sccsfile(4) 

/start/stop the LP request scheduler and move requests.Ipsched(lM) 

common object file, scnhdr: section header for a .scnhdr(4) 

terminals.se: screen editor for video .se(l) 

load and start 3270 emulation script, emulload: .emulload(lM) 

inittab: script for the init process.inittab(4) 

system initialization shell scripts./rc, powerfail: .brc(lM) 

sdb: symbolic debugger.sdb(l) 

program, sdiff: side-by-side difference.sdiff(l) 

terminals, se: screen editor for video.se(l) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

accounting file(s). acctcom: search and print process.acctcom(l) 

Isearch: linear search and update.lsearch(3C) 

bsearch: binary search.bsearch(3C) 

hcreate, hdestroy: manage hash search tables, hsearch, .hsearch(3C) 

tdelete, twalk: manage binary search trees, tsearch,.tsearch(3C) 

jotto: secret word game.jotto(6) 

object file, scnhdr: section header for a common.scnhdr(4) 

object//read an indexed/named section header of a common.ldshread(3X) 

/to line number entries of a section of a common object/.ldlseek(3X) 

/to relocation entries of a section of a common object/.ldrseek(3X) 

/seek to an indexed/named section of a common object/.ldsseek(3X) 

files, size: print section sizes of common object.size(l) 

sed: stream editor.sed(l) 

/mrand48, jrand48, srand48, seed48, lcong48: generate/.drand48(3C) 

section of/ Idsseek, Idnsseek: seek to an indexed/named.ldsseek(3X) 

a section/ Idlseekjdnlseek: seek to line number entries of.ldlseek(3X) 

a section/ Idrseek, Idnrseek: seek to relocation entries of .ldrseek(3X) 

header of a common/ Idohseek: seek to the optional file.ldohseek(3X) 

common object file. Idtbseek: seek to the symbol table of a.ldtbseek(3X) 

shmget: get shared memory segment.shmget(2) 

brk, sbrk: change data segment space allocation.brk(2) 

to two sorted files, comm: select or reject lines common.comm(l) 

greek: select terminal filter.greek(l) 

of a file, cut: cut out selected fields of each line.cut(l) 

file, dump: dump selected parts of an object.dump(l) 

semctl: semaphore control operations.semctl(2) 

semop: semaphore operations.semop(2) 

iperm: remove a message queue, semaphore set or shared memory/.ipcrm(l) 

semget: get set of semaphores.semget(2) 

operations, semctl: semaphore control.semctl(2) 

semget: get set of semaphores.semget(2) 

semop: semaphore operations.semop(2) 

Message, prm: send a Processor Recovery.prm(lM) 

a group of processes, kill: send a signal to a process or .kill(2) 

the NSC network, nusend: send files to another UNIX on .nusend(lC) 

6000. fsend: send files to the HONEYWELL.fsend(lC) 

and/or submit RJE jobs, send, gath: gather files .send(lC) 

gcosmail: send mail to HIS user.gcosmail(lC) 

mail, mail, rmail: send mail to users or read.mail(l) 

the HONEYWELL 6000. gcat: send phototypesetter output to .gcat(lC) 
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Permuted Index 


line printer. Ip, cancel: 
daemon, dpd, Ipd: HONEYWELL 
stream. 
IDs. setuid, 
getgrent, getgrgid, getgrnam, 
goto. 

encryption, crypt, 
action. 

getpwent, getpwuid, getpwnam, 
modify the System Status/ ssr, 
login time, profile: 
gettydefs: speed and terminal 
group IDs. 
/getutid, getutline, pututline, 
data in a machine/ sputl, 
standard/restricted command/ 
operations, shmctl: 
queue, semaphore set or 
/multiple-access-user-space 
shmop: 
shmget: get 
system: issue a 
system: issue a 
shutacct, startup, tumacct: 
system initialization 
command programming/ sh, rsh: 

operations. 

segment, 
operations, 
/prdaily, prtacct, runacct, 
processing, 
program, sdiff: 
transfer-of-sign intrinsic/ 
login: 

terminal, stlogin: 
pause: suspend process until 
what to do upon receipt of a 
action on receipt of a system 
on receipt of a system/ 
upon receipt of a signal, 
of processes, kill: send a 
ssignal, gsignal: software 
lex: generate programs for 
generator, rand, srand: 
tc: phototypesetter 
atan, atan2: trigonometric/ 
intrinsic function, 
sin, dsin, csin: Fortran 
/dsinh: Fortran hyperbolic 
functions, 
hyperbolic sine intrinsic/ 
common object files. 

files. 

size: print section 
size: print 

an interval, 
interval. 

documents, view graphs, and 
typesetting view graphs and 
current/ ttyslot: find the 
spline: interpolate 
int, ifix, idint, real, float, 

sno: 

ssignal, gsignal: 
mllLMLll 
sort: 

qsort: quicker 


send/cancel requests to an LP.lp(l) 

sending daemon, line printer.dpd(lC) 

setbuf: assign buffering to a .setbuf(3S) 

setgid: set user and group .setuid(2) 

setgrent, endgrent: get group/.getgrent(3C) 

setjmp, longjmp: non-local.setjmp(3C) 

setkey, encrypt: generate DES .crypt(3C) 

setmnt: establish mount table.setmnt(lM) 

setmrf: override system MRF.setmrf(lM) 

setpgrp: set process group ID.setpgrp(2) 

setpwent, endpwent: get/ .getpwent(3C) 

setssr, clrssr: print or.ssr(lM) 

setting up an environment at.profile(4) 

settings used by getty.gettydefs(4) 

setuid, setgid: set user and.setuid(2) 

setutent, endutent, utmpname:/.getut(3C) 

sgetl: access long numeric.sputl(3X) 

sh, rsh: shell, the.sh(l) 

shared memory control.shmctl(2) 

shared memory id. /a message .ipcrm(l) 

(shared memory) operations.maus(2) 

shared memory operations.shmop(2) 

shared memory segment.shmget(2) 

shell command from Fortran.system(3F) 

shell command.system(3S) 

shell procedures for//runacct, .acctsh(lM) 

shell scripts, /rc, powerfail: .brc(lM) 

shell, the standard/restricted .sh(l) 

shmctl: shared memory control.shmctl(2) 

shmget: get shared memory .shmget(2) 

shmop: shared memory.shmop(2) 

shutacct, startup, tumacct:/.acctsh(lM) 

shutdown: terminate all.shutdown(lM) 

side-by-side difference .sdiff(l) 

sign, isign, dsign: Fortran.sign(3F) 

sign on.login(l) 

sign on to synchronous.stlogin(l) 

signal.pause(2) 

signal, signal: specify.signal(2) 

signal, /specify Fortran.signal(3F) 

signal: specify Fortran action.signal(3F) 

signal: specify what to do.signal(2) 

signal to a process or a group.kill(2) 

signals.ssignal(3C) 

simple lexical tasks.lex( 1) 

simple random-number.rand(3C) 

simulator.tc(l) 

sin, cos, tan, asin, acos,.trig(3M) 

sin, dsin, csin: Fortran sine.sin(3F) 

sine intrinsic function.sin(3F) 

sine intrinsic function.sinh(3F) 

sinh, cosh, tanh: hyperbolic .sinh(3M) 

sinh, dsinh: Fortran.sinh(3F) 

size: print section sizes of.size(l) 

size: print sizes of object .size.pdp(l) 

sizes of common object files.size(l) 

sizes of object files.size.pdp(l) 

sky: obtain ephemerides.sky(6) 

sleep: suspend execution for.sleep(l) 

sleep: suspend execution for.sleep(3C) 

slides, mmt, mvt: typeset .mmt(l) 

slides, /macro package for.mv(5) 

slot in the utmp file of the.ttyslot(3C) 

smooth curve.spline(lG) 

sngl, dble, cmplx, dcmplx,/ .ftype(3F) 

sno: SNOBOL interpreter.sno(l) 

SNOBOL interpreter.sno(l) 

software signals.ssignal(3C) 

solid-state disk.ml 11 (7) 

sort and/or merge files.sort(l) 

sort.qsort(3C) 

sort: sort and/or merge files.sort(l) 
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Permuted Index 


tsort: topological sort.tsort(l) 

or reject lines common to two sorted files, comm: select.comm(l) 

object file, list: produce C source listing from 3B20S.list(l) 

brk, sbrk: change data segment space allocation.brk(2) 

terminal, ct: spawn getty to a remote.ct(lC) 

sys3b: 3B20S specific system calls.sys3b(2) 

fspec: format specification in text files.fspec(4) 

nsc: NSC adapter interface specification.nsc(7) 

receipt of a system/ signal: specify Fortran action on .signal(3F) 

receipt of a signal, signal: specify what to do upon.signal(2) 

/set terminal type, modes, speed, and line discipline.getty(lM) 

used by getty. gettydefs: speed and terminal settings.gettydefs(4) 

tn85: medium speed line printer controller.tn85(7) 

hashcheck: find spelling/ spell, hashmake, spellin,.spell(l) 

spelling/spell, hashmake, spellin, hashcheck: find.spell(l) 

spellin, hashcheck: find spelling errors./hashmake, .spell(l) 

curve, spline: interpolate smooth.spline(lG) 

split: split a file into pieces.split(l) 

csplit: context split.csplit(l) 

files, fsplit: split f77, ratfor, or efl.fsplit(l) 

pieces, split: split a file into .split(l) 

unclean: uucp spool directory clean-up.uuclean(lM) 

Ipr: line printer spooler.Ipr(l) 

chmap: change the diagnostic spooler map file.chmap(lM) 

vpr: Versatec printer spooler.vpr(l) 

Ipadmin: configure the LP spooling system.Ipadmin(lM) 

output, printf, fprintf, sprintf: print formatted .printf(3S) 

numeric data in a machine/ sputl, sgetl: access long.sputl(3X) 

square root intrinsic/ sqrt, dsqrt, csqrt: Fortran .sqrt(3F) 

power,/exp, log, loglO, pow, sqrt: exponential, logarithm,.exp(3M) 

exponential, logarithm, power, square root functions, /sqrt: .exp(3M) 

sqrt, dsqrt, csqrt: Fortran square root intrinsic/.sqrt(3F) 

random-number generator, srand, rand: Fortran uniform.rand(3F) 

generator, rand, srand: simple random-number .rand(3C) 

/nrand48, mrand48, jrand48, srand48, seed48, lcong48:/.drand48(3C) 

input, scanf, fscanf, sscanf: convert formatted .scanf(3S) 

signals, ssignal, gsignal: software .ssignal(3C) 

modify the System Status/ ssr, setssr, clrssr: print or .ssr(lM) 

control. St: synchronous terminal.st(lM) 

interface, st: synchronous terminal.st(7) 

on-line diagnostic requests, sta: find status of pending.sta(lM) 

see: C compiler for stand-alone programs.scc(l) 

package, stdio: standard buffered input/output .stdio(3S) 

communication/ stdipc: standard interprocess.stdipc(3C) 

sh, rsh: shell, the standard/restricted command/.sh(l) 

emulload: load and start 3270 emulation script.emulload(lM) 

on-line/dstart, dstop, dstat: start, stop and find status of .dstart(lM) 

Ipsched, Ipshut, Ipmove: start/stop the LP request/ .Ipsched(lM) 

unixboot: UNIX startup and boot procedures.unixboot(8) 

/prtacct, runacct, shutacct, startup, turnacct: shell/ .acctsh(lM) 

system call, stat: data returned by stat .stat(5) 

stat, fstat: get file status.stat(2) 

useful with graphical/ stat: statistical network .stat(lG) 

stat: data returned by stat system call.stat(5) 

with graphical/stat: statistical network useful .stat(lG) 

ff: list file names and statistics for a file system.ff(lM) 

ustat: get file system statistics.ustat(2) 

status report and interactive status console, rjestat: RJE.rjestat(lC) 

on, logically off or display status./device logically.don(lM) 

emulation controller/terminal status, emulstat: get 3270 .emulstat(lM) 

/install, remove, or get status for a BX.25 minor/.x25pvc(lM) 

Ipstat: print LP status information.Ipstat(l) 

feof, clearerr, fileno: stream status inquiries, ferror, .ferror(3S) 

control, uustat: uucp status inquiry and job.uustat(lC) 

communication facilities status, /report inter-process .ipcs(l) 

/dstat: start, stop and find status of on-line diagnostics.dstart(lM) 

diagnostic/sta: find status of pending on-line .sta(lM) 

nscstat: query the operation status of the NSC network.nscstat(lC) 

ps: report process status.ps(l) 

print or modify the System Status Register./clrssr:.ssr(lM) 

status console, rjestat: RJE status report and interactive .rjestat(lC) 

stat, fstat: get file status.stat(2) 
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Permuted Index 


terminal facilities status./report synchronous .ststat(l) 

input/output package, stdio: standard buffered.stdio(3S) 

communication package, stdipc: standard interprocess.stdipc(3C) 

terminal interface, stermio: general synchronous.stermio(7) 

login line for use. stgetty: wait on synchronous.stgetty(lM) 

stime: set time.stime(2) 

synchronous terminal, stlogin: sign on to.stlogin(l) 

dstart, dstop, dstat: start, stop and find status of/ .dstart(lM) 

wait for child process to stop or terminate, wait:.wait(2) 

strncmp, strcpy, stmcpy,/ strcat, stmcat, strcmp,.string(3C) 

/strcpy, strncpy, strlen, strchr, strrchr, strpbrk,/.string(3C) 

stmcpy,/ strcat, stmcat, strcmp, strncmp, strcpy,.string(3C) 

/strncat, strcmp, strncmp, strcpy, stmcpy, strlen,/ .string(3C) 

/strrchr, strpbrk, strspn, strcspn, strtok: string/.string(3C) 

sed: stream editor.sed(l) 

fflush: close or flush a stream, fclose, .fclose(3S) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

reposition a file pointer in a stream, fseek, rewind, ftell: .fseek(3S) 

get character or word from stream./getchar, fgetc, getw:.getc(3S) 

fgets: get a string from a stream, gets, .gets(3S) 

put character or word on a stream, /putchar, fputc, putw: .putc(3S) 

puts, fputs: put a string on a stream.puts(3S) 

setbuf: assign buffering to a stream.setbuf(3S) 

/feof, clearerr, fileno: stream status inquiries.ferror(3S) 

push character back into input stream, ungetc: .ungetc(3S) 

long integer and base-64 ASCII string. /164a: convert between .a641(3C) 

convert date and time to string, /asctime, tzset:.ctime(3C) 

floating-point number to string, /fcvt, gcvt: convert.ecvt(3C) 

gps: graphical primitive string, format of graphical/.gps(4) 

gets, fgets: get a string from a stream.gets(3S) 

len: return length of Fortran string.len(3F) 

puts, fputs: put a string on a stream.puts(3S) 

strspn, strcspn, strtok: string operations, /strpbrk,.string(3C) 

number, atof: convert ASCII string to floating-point .atof(3C) 

strtol, atol, atoi: convert string to integer.strtol(3C) 

relocation bits, strip: remove symbols and.strip.pdp(l) 

number information from a/ strip: strip symbol and line.strip(l) 

information from a/strip: strip symbol and line number.strip(l) 

/strncmp, strcpy, strncpy, strlen, strchr, strrchr,/.string(3C) 

strcpy, strncpy,/ strcat, stmcat, strcmp, strncmp,.string(3C) 

strcat, strncat, strcmp, strncmp, strcpy, stmcpy,/ .string(3C) 

/strcmp, strncmp, strcpy, stmcpy, strlen, strchr,/ .string(3C) 

/strlen, strchr, strrchr, strpbrk, strspn, strcspn,/.string(3C) 

/strncpy, strlen, strchr, strrchr, strpbrk, strspn,/.string(3C) 

/strchr, strrchr, strpbrk, strspn, strcspn, strtok:/ .string(3C) 

/strpbrk, strspn, strcspn, strtok: string operations.string(3C) 

string to integer, strtol, atol, atoi: convert.strtol(3C) 

processes using a file or file structure, fuser: identify.fuser(lM) 

terminal facilities status, ststat: report synchronous.ststat(l) 

terminal, stty: set the options for a.stty(l) 

another user, su: become super-user or .su(l) 

gath: gather files and/or submit RJE jobs, send,.send(lC) 

intro: introduction to subroutines and libraries.intro(3) 

plot: graphics interface subroutines.plot(3X) 

/same lines of several files or subsequent lines of one file.paste(l) 

return location of Fortran substring, index:.index(3F) 

count of a file, sum: print checksum and block.sum(l) 

du: summarize disk usage.du(l) 

accounting/acctcms: command summary from per-process.acctcms(lM) 

sync: update the super block.sync(l) 

sync: update super-block.sync(2) 

su: become super-user or another user.su(l) 

interval, sleep: suspend execution for an .sleep(l) 

interval, sleep: suspend execution for.sleep(3C) 

pause: suspend process until signal.pause(2) 

swab: swap bytes.swab(3C) 

swab: swap bytes.swab(3C) 

information from/strip: strip symbol and line number.strip(l) 

object//compute the index of a symbol table entry of a common .ldtbindex(3X) 

Idtbread: read an indexed symbol table entry of a common/.ldtbread(3X) 

syms: common object file symbol table format.syms(4) 

object/ Idtbseek: seek to the symbol table of a common.ldtbseek(3X) 
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Permuted Index 


sdb: symbolic debugger.sdb(l) 

strip: remove symbols and relocation bits.strip.pdp(l) 

symbol table format, syms: common object file.syms(4) 

sync: update super-block.sync(2) 

sync: update the super block.sync(l) 

un53: UN53/TN82 synchronous device interface.un53(7) 

du:DU-ll synchronous line interface.du(7) 

use. stgetty: wait on synchronous login line for.stgetty(lM) 

concatenate and print files on synchronous printer, scat:.scat(l) 

St: synchronous terminal control.st(lM) 

facilities/ststat: report synchronous terminal.ststat(l) 

interface, st: synchronous terminal.st(7) 

interface, stermio: general synchronous terminal.stermio(7) 

stlogin: sign on to synchronous terminal.stlogin(l) 

calls. sys3b: 3B20S specific system .sys3b(2) 

sysdef: system definition.sysdef(lM) 

error/ perror, errno, sys_errlist, sys_nerr: system.perTor(3C) 

perror, ermo, sys_errlist, sys nerr: system error/ .perTor(3C) 

/compute the index of a symbol table entry of a common object/.ldtbindex(3X) 

file, /read an indexed symbol table entry of a common object.ldtbread(3X) 

common object file symbol table format, syms:.syms(4) 

master device information table, master:.master.dec(4) 

master device information table, master:.master.u3b(4) 

mnttab: mounted file system table.mnttab(4) 

Idtbseek: seek to the symbol table of a common object file.ldtbseek(3X) 

toe: graphical table of contents routines.toc(lG) 

setmnt: establish mount table.setmnt(lM) 

tbl: format tables for nroff or troff.tbl(l) 

hdestroy: manage hash search tables, hsearch, hcreate,.hsearch(3C) 

tabs: set tabs on a terminal.tabs(l) 

tabs: set tabs on a terminal.tabs(l) 

a file, tail: deliver the last part of.tail(l) 

trigonometric/ sin, cos, tan, asin, acos, atan, atan2:.trig(3M) 

intrinsic function, tan, dtan: Fortran tangent .tan(3F) 

tan, dtan: Fortran tangent intrinsic function.tan(3F) 

/dtanh: Fortran hyperbolic tangent intrinsic function.tanh(3F) 

hyperbolic tangent intrinsic/ tanh, dtanh: Fortran .tanh(3F) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

tapeboot: magnetic tape bootstrap program.tapeboot(8) 

gt: general driver for tape drives.gt(7) 

hpio: HP 2645A terminal tape file archiver.hpio(l) 

tar: tape file archiver.tar(l) 

recover files from a backup tape, free: .frec(lM) 

ht: TUI6/TE16 magnetic tape interface.ht(7) 

tm: TM11/TUI0 magnetic tape interface.tm(7) 

ts: TS11 magnetic tape interface.tsll(7) 

tu78: TU78 magnetic tape interface.tu78(7) 

un32: magnetic tape interface.un32(7) 

un52: magnetic tape interface.un52(7) 

Idtape: load disk from tape procedures.ldtape(8) 

bootstrap program, tapeboot: magnetic tape.tapeboot(8) 

file system backup, filesave, tapesave: daily/weekly UNIX.filesave(lM) 

tar: tape file archiver.tar(l) 

programs for simple lexical tasks, lex: generate.lex(l) 

deroff: remove nroff/troff, tbl, and eqn constructs.deroff(l) 

or troff. tbl: format tables for nroff.tbl(l) 

tc: phototypesetter simulator.tc(l) 

hpd, erase, hardcopy, tekset, td: graphical device routines/.gdev(lG) 

search trees, tsearch, tdelete, twalk: manage binary.tsearch(3C) 

tee: pipe fitting.tee(l) 

hpd, erase, hardcopy, tekset, td: graphical device/ .gdev(lG) 

4014: paginator for the Tektronix 4014 terminal.4014( 1) 

initialization, init, telinit: process control .init(lM) 

temporary file, tmpnam, tempnam: create a name for a.tmpnam(3S) 

tmpfile: create a temporary file.tmpfile(3S) 

tempnam: create a name for a temporary file, tmpnam,.tmpnam(3S) 

terminals, term: conventional names for.term(5) 

for the Tektronix 4014 terminal. 4014: paginator.4014(1) 

functions of the DASI 450 terminal. 450: handle special. 450(1) 

St: synchronous terminal control.st(lM) 

ct: spawn getty to a remote terminal.ct(lC) 

generate file name for terminal, ctermid:.ctermid(3S) 
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Permuted Index 


ststat: report synchronous terminal facilities status.ststat(l) 

greek: select terminal filter.greek(l) 

St: synchronous terminal interface.st(7) 

stermio: general synchronous terminal interface.stermio(7) 

termio: general terminal interface.termio(7) 

tty: controlling terminal interface.tty(7) 

dial: establish an out-going terminal line connection.dial(3C) 

getty. gettydefs: speed and terminal settings used by .gettydefs(4) 

sign on to synchronous terminal, stlogin: .stlogin(l) 

stty: set the options for a terminal.stty(l) 

tabs: set tabs on a terminal.tabs(l) 

hpio: HP 2645A terminal tape file archiver.hpio(l) 

isatty: find name of a terminal, ttyname,.ttyname(3C) 

and line/getty: set terminal type, modes, speed,.getty(lM) 

functions of DASI 300 and 300s terminals, /handle special. 300(1) 

of HP 2640 and 2621-series terminals./special functions.hp(l) 

tty: get the terminal’s name.tty(l) 

se: screen editor for video terminals.se(l) 

term: conventional names for terminals.term(5) 

kill: terminate a process.kill(l) 

shutdown: terminate all processing.shutdown(lM) 

abort: terminate Fortran program.abort(3F) 

exit, _exit: terminate process.exit(2) 

daemon, errstop: terminate the error-logging.errstop(lM) 

for child process to stop or terminate, wait: wait.wait(2) 

interface, termio: general terminal.termio(7) 

command, test: condition evaluation .test(l) 

vpmtest: test KMC lines.vpmtest(lM) 

fts: Field Test Set interface.fts(lM) 

quiz: test your knowledge.quiz(6) 

ed, red: text editor.ed(l) 

change the format of a text file, newform:.newform(l) 

fspec: format specification in text files.fspec(4) 

/checkeq: format mathematical text for nroff or troff..eqn(l) 

prepare constant-width text for troff. cw, checkcw: .cw(l) 

nroff: format text.nroff(l) 

plock: lock process, text, or data in memory.plock(2) 

troff: typeset text.troff(l) 

ttt, cubic: tic-tac-toe.ttt(6) 

data and system/timex: time a command; report process.timex(l) 

time: time a command.time(l) 

mclock: return Fortran time accounting.mclock(3F) 

systems for optimal access time, dcopy: copy file .dcopy(lM) 

time: get time.time(2) 

profil: execution time profile.profil(2) 

up an environment at login time, profile: setting.profile(4) 

stime: set time.stime(2) 

time: time a command.time(l) 

time: get time.time(2) 

tzset: convert date and time to string, /asctime,.ctime(3C) 

clock: report CPU time used.clock(3C) 

process times, times: get process and child .times(2) 

update access and modification times of a file, touch:.touch(l) 

get process and child process times, times: .times(2) 

file access and modification times, utime: set.utime(2) 

process data and system/ timex: time a command; report.timex(l) 

interface, tm: TMl 1/TUlO magnetic tape.tni(7) 

interface, tm: TMl 1/TUlO magnetic tape .tm(7) 

file, tmpfile: create a temporary.tmpfile(3S) 

for a temporary file, tmpnam, tempnam: create a name.tmpnam(3S) 

interface. tn4: eight line asynchronous.tn4(7) 

interface. tn74: two line asynchronous.tn74(7) 

interface. tn83: console/printer.tn83(7) 

printer controller. tn85: medium speed line.tn85(7) 

/tolower, toupper, tolower, toascii: translate characters.conv(3C) 

contents routines, toe: graphical table of.toc(lG) 

popen, pclose: initiate pipe to/from a process.popen(3S) 

toupper, tolower, _toupper, tolower, toascii: translate/.conv(3C) 

toascii: translate/ toupper, tolower, _toupper, tolower,.conv(3C) 

tsort: topological sort.tsort(l) 

acetmerg: merge or add total accounting files.acctmerg(lM) 

modification times of a file, touch: update access and .touch(l) 
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Permuted Index 


translate/ toupper, tolower, toupper, tolower, toascii: .conv(3C) 

tolower, toascii: translate/ toupper, tolower, toupper, .conv(3C) 

tplot: graphics filters.tplot(lG) 

tr: translate characters.tr(l) 

trace: event-tracing driver.trace(7) 

ptrace: process trace.ptrace(2) 

save and print VPM event traces, vpmsave, vpmfmt:.vpmsave(lM) 

sign, isign, dsign: Fortran transfer-of-sign intrinsic/ .sign(3F) 

/ toupper, tolower, toascii: translate characters.conv(3C) 

tr: translate characters.tr(l) 

atb: attach to an Address Translation Buffer.atb(lM) 

ftw: walk a file tree.ftw(3C) 

twalk: manage binary search trees, tsearch, tdelete,.tsearch(3C) 

tan, asin, acos, atan, atan2: trigonometric functions, /cos, .trig(3M) 

constant-width text for troff. cw, checkcw: prepare .cw(l) 

mathematical text for nroff or troff./neqn, checkeq: format.eqn(l) 

typesetting view graphs/ mv: a troff macro package for.mv(5) 

format tables for nroff or troff. tbl:.tbl(l) 

troff: typeset text.troff(l) 

trouble: log a trouble report.trouble(l) 

trouble: log a trouble report.trouble(l) 

trouble: trouble reporting system.trouble(8) 

system, trouble: trouble reporting .trouble(8) 

values, true, false: provide truth.true(l) 

pdpl 1, u3b, u3b5, vax: provide truth value about your/ .machid(l) 

true, false: provide truth values.tme(l) 

interface, ts: TSl 1 magnetic tape .tsll(7) 

ts: TSl 1 magnetic tape interface.tsll(7) 

manage binary search trees, tsearch, tdelete, twalk: .tsearch(3C) 

tsort: topological sort.tsort(l) 

ttt, cubic: tic-tac-toe.ttt(6) 

interface, tty: controlling terminal.tty(7) 

tty: get the terminal’s name.tty(l) 

graphics for the extended TTY-37 type-box. greek: .greek(5) 

a terminal, ttyname, isatty: find name of.ttyname(3C) 

utmp file of the current/ ttyslot: find the slot in the.ttyslot(3C) 

interface, ht: TU16/TE16 magnetic tape.ht(7) 

tu78: TU78 magnetic tape interface.tu78(7) 

interface. tu78: TU78 magnetic tape.tu78(7) 

/runacct, shutacct, startup, turnacct: shell procedures for/ .acctsh(lM) 

trees, tsearch, tdelete, twalk: manage binary search.tsearch(3C) 

ichar, char: explicit Fortran type conversion, /dcmplx,.ftype(3F) 

file: determine file type.file(l) 

value about your processor type, /vax: provide truth.machid(l) 

getty: set terminal type, modes, speed, and line/.getty(lM) 

for the extended TTY-37 type-box. greek: graphics.greek(5) 

types, types: primitive system data.types(5) 

types: primitive system data types.types(5) 

graphs, and slides, mmt, mvt: typeset documents, view.mmt(l) 

troff: typeset text.troff(l) 

mv: a troff macro package for typesetting view graphs and/.mv(5) 

/localtime, gmtime, asctime, tzset: convert date and time/.ctime(3C) 

value about your/pdpl 1, u3b, u3b5, vax: provide truth.machid(l) 

about your/pdpl 1, u3b, u3b5, vax: provide truth value .machid(l) 

getpw: get name from UID.getpw(3C) 

limits, ulimit: get and set user .ulimit(2) 

creation mask, umask: set and get file .umask(2) 

mask, umask: set file-creation mode.umask(l) 

file system, mount, umount: mount and dismount.mount(lM) 

umount: unmount a file system.umount(2) 

un32: magnetic tape interface.un32(7) 

un52: magnetic tape interface.un52(7) 

synchronous device interface. un53: UN53/TN82.un53(7) 

device interface. un53: UN53/TN82 synchronous.un53(7) 

UNIX system, uname: get name of current .uname(2) 

UNIX system, uname: print name of current.uname(l) 

file, unget: undo a previous get of an SCCS.unget(l) 

an sees file, unget: undo a previous get of.unget(l) 

into input stream, ungetc: push character back .ungetc(3S) 

srand, rand: Fortran uniform random-number/ .rand(3F) 

/seed48, lcong48: generate uniformly distributed/.drand48(3e) 

a file, uniq: report repeated lines in.uniq(l) 
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Permuted Index 


mktemp: make a unique file name.mktemp(3C) 

acu, dn: Automatic Call Unit (ACU) interface.acu(7) 

on-line/rmv: remove unit from service before.rmv(lM) 

diagnostics, rst: restore unit to service after on-line.rst(lM) 

units: conversion program.units(l) 

boot procedures, unixboot: UNIX startup and.unixboot(8) 

uuto, uupick: public UNIX-to-UNIX file copy.uuto(lC) 

unlink system calls, link, unlink: exercise link and.link(lM) 

entry, unlink: remove directory .unlink(2) 

unlink: exercise link and unlink system calls, link, .link(lM) 

umount: unmount a file system.umount(2) 

files, pack, peat, unpack: compress and expand .pack(l) 

times of a file, touch: update access and modification.touch(l) 

of programs, make: maintain, update, and regenerate groups .make(l) 

Isearch: linear search and update.lsearch(3C) 

sync: update super-block.sync(2) 

sync: update the super block.sync(l) 

du: summarize disk usage.du(l) 

stat: statistical network useful with graphical/.stat(lG) 

id: print user and group IDs and names.id(l) 

setuid, setgid: set user and group IDs.setuid(2) 

character login name of the user, cuserid: get .cuserid(3S) 

/getgid, getegid: get real user, effective user, real/.getuid(2) 

environ: user environment.environ(5) 

gcosmail: send mail to HIS user.gcosmail(lC) 

ulimit: get and set user limits.ulimit(2) 

logname: return login name of user.logname(3X) 

/get real user, effective user, real group, and/.getuid(2) 

become super-user or another user, su:.su(l) 

the utmp file of the current user, /find the slot in.ttyslot(3C) 

write: write to another user.write(l) 

mail, rmail: send mail to users or read mail.mail(l) 

wall: write to all users.wall(lM) 

fuser: identify processes using a file or file/.fuser(lM) 

statistics, ustat: get file system .ustat(2) 

gutil: graphical utilities.gutil(lG) 

modification times, utime: set file access and .utime(2) 

utmp, wtmp: utmp and wtmp entry formats.utmp(4) 

endutent, utmpname: access utmp file entry, /setutent, .getut(3C) 

ttyslot: find the slot in the utmp file of the current user.ttyslot(3C) 

entry formats, utmp, wtmp: utmp and wtmp.utmp(4) 

/pututline, setutent, endutent, utmpname: access utmp file/.getut(3C) 

clean-up. uuclean: uucp spool directory.uuclean(lM) 

uusub: monitor uucp network.uusub(lM) 

uuclean: uucp spool directory clean-up.uuclean(lM) 

control, uustat: uucp status inquiry and job.uustat(lC) 

Unix copy, uucp, uulog, uuname: unix to.uucp(lC) 

copy, uucp, uulog, uuname: Unix to Unix.uucp(lC) 

uucp, uulog, uuname: Unix to Unix copy.uucp(lC) 

file copy, uuto, uupick: public UNIX-to-UNIX.uuto(lC) 

and job control, uustat: uucp status inquiry.uustat(lC) 

uusub: monitor uucp network.uusub(lM) 

UNIX-to-UNIX file copy, uuto, uupick: public .uuto(lC) 

execution, uux: unix to unix command .uux(lC) 

val: validate SCCS file.val(l) 

val: validate SCCS file.val(l) 

/u3b, u3b5, vax: provide truth value about your processor/ .machid(l) 

abs: return integer absolute value.abs(3C) 

cabs, zabs: Fortran absolute value, abs, iabs, dabs,.abs(3F) 

getenv: return value for environment name.getenv(3C) 

ceiling, remainder, absolute value functions, /fabs: floor,.floor(3M) 

true, false: provide truth values.true(l) 

return Fortran environment variable, getenv:.getenv(3F) 

your/pdpl 1, u3b, u3b5, vax: provide truth value about .machid(l) 

750ops: VAX-11/750 console operations. 750ops(8) 

verification program, vcf: VAX-11/780 configuration .vcf(lM) 

780ops: VAX-11/780 console operations. 780ops(8) 

interface, vlx: VAX-11/780 LSI console floppy .vlx(lM) 

files between PDP-11 and VAX-11/780 systems./convert.fscv(lM) 

VC: version control.vc(l) 

verification program, vcf: VAX-11/780 configuration.vcf(lM) 

option letter from argument vector, getopt: get.getopt(3C) 
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Permuted Index 


vcf: VAX-11/780 configuration verification program.vcf(lM) 

dskfmt, dskvfy: format and verify disk packs.dskfmt(lM) 

assert: verify program assertion.assert(3X) 

vpr: Versatec printer spooler.vpr(l) 

vp: Versatec printer.vp(7) 

vc: version control.vc(l) 

get: get a version of an SCCS file.get(l) 

sccsdiff: compare two versions of an SCCS file.sccsdiff(l) 

se: screen editor for video terminals.se(l) 

mmt, mvt: typeset documents, view graphs, and slides.mmt(l) 

macro package for typesetting view graphs and slides./troff.mv(5) 

vpm: Virtual Protocol Machine.vpm(7) 

vpmc: compiler for the virtual protocol machine.vpmc.dec(lM) 

vpmc: compiler for the virtual protocol machine.vpmc.u3b(lM) 

floppy interface, vlx: VAX-11/780 LSI console .vlx(lM) 

systems with label checking, volcopy, labelit: copy file .volcopy(lM) 

file system: format of system volume.fs(4) 

vp: Versatec printer.vp(7) 

vpmset, vpmstart: connect/load VPM drivers and programmable/.vpmset(lM) 

vpmfmt: save and print VPM event traces, vpmsave,.vpmsave(lM) 

vpm: Virtual Protocol Machine.vpm(7) 

protocol machine, vpmc: compiler for the virtual .vpmc.dec(lM) 

protocol machine, vpmc: compiler for the virtual .vpmc.u3b(lM) 

event traces, vpmsave, vpmfmt: save and print VPM.vpmsave(lM) 

print VPM event traces, vpmsave, vpmfmt: save and .vpmsave(lM) 

VPM drivers and programmable/ vpmset, vpmstart: connect/load.vpmset(lM) 

drivers and/vpmset, vpmstart: connect/load VPM.vpmset(lM) 

vpmtest: test KMC lines.vpmtest(lM) 

vpr: Versatec printer spooler.vpr(l) 

newboot: load VTOC, prom patch, or Iboot.newboot(lM) 

process, wait: await completion of.wait(l) 

or terminate, wait: wait for child process to stop.wait(2) 

foruse. stgetty: wait on synchronous login line.stgetty(lM) 

to stop or terminate, wait: wait for child process.wait(2) 

ftw: walk a file tree.ftw(3C) 

wall: write to all users.wall(lM) 

wc: word count.wc(l) 

what: identify SCCS files.what(l) 

signal, signal: specify what to do upon receipt of a .signal(2) 

crashes, crash: what to do when the system .crash.dec(8) 

crashes, crash: what to do when the system .crash.u3b(8) 

whodo: who is doing what.whodo(lM) 

who: who is on the system.who(l) 

who: who is on the system.who(l) 

whodo: who is doing what.whodo(lM) 

cd: change working directory.cd(l) 

chdir: change working directory.chdir(2) 

get path-name of current working directory, getcwd: .getcwd(3C) 

pwd: working directory name.pwd(l) 

write: write on a file.write(2) 

putpwent: write password file entry.putpwent(3C) 

wall: write to all users.wall(lM) 

write: write to another user.write(l) 

write: write on a file.write(2) 

write: write to another user.write(l) 

open: open for reading or writing.open(2) 

utmp, wtmp: utmp and wtmp entry formats.utmp(4) 

formats, utmp, wtmp: utmp and wtmp entry.utmp(4) 

accounting records, fwtmp, wtmpfix: manipulate connect.fwtmp(lM) 

hunt-the-wumpus. wump: the game of.wump(6) 

x25: BX.25 network interface.x25(7) 

install a BX.25 link. x25alnk, x25ilnk: attach or.x25alnk(3C) 

link. x25clnk: change over a BX.25 .x25clnk(3C) 

BX.25 link. x25hlnk, x25dlnk: halt or detach a .x25hlnk(3C) 

detach a BX.25 link. x25hlnk, x25dlnk: halt or .x25hlnk(3C) 

BX.25 link. x25alnk, x25ilnk: attach or install a.x25alnk(3C) 

remove a PVC on a link. x25ipvc, x25rpvc: install or .x25ipvc(3C) 

get status for a/x25pvc, x251nk: install, remove, or.x25pvc(lM) 

remove, or get status for a/ x25pvc, x251nk: install,.x25pvc(lM) 

PVC on a link. x25ipvc, x25rpvc: install or remove a.x25ipvc(3C) 

list(s) and execute command, xargs: construct argument.xargs(l) 

Fortran bitwise/ and, or, xor, not, Ishift, rshift:.bool(3F) 
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Permuted Index 


jO,jl,jn, yO, yl, yn: Bessel functions.bessel(3M) 

jO,jl,jn,yO, yl, yn: Bessel functions.bessel(3M) 

compiler-compiler, yacc: yet another.yacc(l) 

jO, jl, jn, yO, yl, yn: Bessel functions.bessel(3M) 

abs, iabs, dabs, cabs, zabs: Fortran absolute value.abs(3F) 
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INTRO (IM) 


INTRO (IM) 


NAME 

intro - introduction to system maintenance commands and application programs 

DESCRIPTION 

This section describes, in alphabetical order, commands that are used chiefly for system maintenance and 
administration purposes. The commands in this section should be used along with those listed in Section 1 
of the UNIX System User’s Manual. References to other manual entries not of the form name (IM), 
name (7) or name{%) refer to entries of that manual. 

COMMAND SYNTAX 

Unless otherwise noted, commands described in this section accept options and other arguments according 
to the following syntax: 

name [option{sy\ [cmdarg{sy\ 
where: 


name 

option 


noargletter 

argletter 

optarg 

cmdarg 


The name of an executable file. 

- noargletter(s) or, 

- argletterOoptarg 

where <> is optional white space. 

A single letter representing an option without an argument. 

A single letter representing an option requiring an argument. 

Argument (character string) satisfying preceding argletter. 

Path name (or other command argument) not beginning with - or, - by itself indicating the 
standard input. 


SEE ALSO 

getopt(l), getopt(3C). 

UNIX System User’s Manual. 

UNIX System Administrator’s Guide. 


DIAGNOSTICS 

Upon termination, each command returns two bytes of status, one supplied by the system and giving the 
cause for termination, and (in the case of “normal” termination) one supplied by the program (see wait(2) 
and exit(2)). The former byte is 0 for normal termination; the latter is customarily 0 for successful execu¬ 
tion and non-zero to indicate troubles such as erroneous parameters, bad or inaccessible data, or other 
inability to cope with the task at hand. It is called variously “exit code”, “exit status”, or “return code”, 
and is described only where special conventions are involved. 


BUGS 

Regretfully, many commands do not adhere to the aforementioned syntax. 
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ABT(IM) 


(3B20S only) 


ABT(IM) 


NAME 

abt - abort on-line diagnostics 

SYNOPSIS 

/dgn/bin/abt slot 

DESCRIPTION 

Abt is a diagnostic command which terminates the diagnostic request indicated by the slot. Slot is a number 
from 0 to 9 reported by the Maintenance Input Request Administrator (MIRA) whenever a dgn{\M) or 
rif(lM) command is invoked. 

SEE ALSO 

dgn(lM), dstart(lM), rst(lM). 

3B DMERT Output Messages, OM-4C000-01. 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 
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ACCEPT (IM) 


ACCEPT (IM) 


NAME 

accept, reject - allow/prevent LP requests 

SYNOPSIS 

/usr/lib/accept destinations 
/usr/lib/reject [ -r[ reason ] ] destinations 

DESCRIPTION 

Accept allows lp{\) to accept requests for the named destinations . A destination can be either a printer or a 
class of printers. Use lpstat{\) to find the status of destinations. 

Reject prevents lp{V} from accepting requests for the named destinations . A destination can be either a 
printer or a class of printers. Use lpstat{\) to find the status of destinations . The following option is useful 
with reject. 

-rlreason} Associates a reason with preventing Ip from accepting requests. This reason applies to all 
printers mentioned up to the next -r option. Reason is reported by Ip when users direct 
requests to the named destinations and by Ipstat(l). If the -r option is not present or the -r 
option is given without a reason, then a default reason will be used. 

PILES 

/usr/spool/lp/* 

SEE ALSO 

enable(l), lp(l), Ipadmin(lM), Ipsched(lM), Ipstat(l). 
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ACCT(IM) 


ACCT(IM) 


NAME 

acctdisk, acctdusg, accton, acctwtmp - overview of accounting and miscellaneous accounting commands 

SYNOPSIS 

/usr/lib/acct/acctdisk 


/usr/lib/acct/acctdusg [ -u file ] [ -p file ] 

/usr/lib/acct/accton [ file ] 

/usr/lib/acct/acctwtmp "reason" 

DESCRIPTION 

Accounting software is structured as a set of tools (consisting of both C programs and shell procedures) that 
can be used to build accounting systems. Acctsh{\M) describes the set of shell procedures built on top of 
the C programs. 

Connect time accounting is handled by various programs that write records into /usr/adm/utmp, as 
described in utmp(4). The programs described in flccfcon(lM) convert this file into session and charging 
records, which are then summarized by acctmerg(IM). 

Process accounting is performed by the UNIX System kernel. Upon termination of a process, one record 
per process is written to a file (normally /usr/adm/pacct). The programs in acctprc(lM) summarize this 
data for charging purposes; acctcms(IM) is used to summarize command usage. Current process data may 
be examined using acctcom{\). 

Process accounting and connect time accounting (or any accounting records in the format described in 
accf(4)) can be merged and summarized into total accounting records by acctmerg (see tacct format in 
accf(4)). Prtacct (see acctsh{\M)) is used to format any or all accounting records. 

Acctdisk reads lines that contain user ID, login name, and number of disk blocks and converts them to total 
accounting records that can be merged with other accounting records. 

Acctdusg reads its standard input (usually from find / -print) and computes disk resource consumption 
(including indirect blocks) by login. If -u is given, records consisting of those file names for which 
acctdusg charges no one are placed in file (a potential source for finding users trying to avoid disk charges). 
If -p is given, file is the name of the password file. This option is not needed if the password file is 
/etc/passwd. 

Accton alone turns process accounting off. If file is given, it must be the name of an existing file, to which 
the kernel appends process accounting records (see acct(2) and accf(4)). 

Acctwtmp writes a utmp(4) record to its standard output. The record contains the current time and a string 
of characters that describe the reason. A record type of ACCOUNTING is assigned (see utmp{4)). Reason 
must be a string of 11 or less characters, numbers, $, or spaces. For example, the following are suggestions 
for use in reboot and shutdown procedures, respectively: 

acctwtmp ' uname' » /etc/wtmp 
acctwtmp "file save" » /etc/wtmp 


EILES 

/etc/passwd 

/usr/lib/acct 

/usr/adm/pacct 

/etc/wtmp 


used for login name to user ID conversions 
holds all accounting commands listed in 
sub-class IM of this manual 
current process accounting file 
login/logoff history file 


SEE ALSO 

acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), 
runacct(lM), acct(2), acct(4), utmp(4). 

UNIX System Accounting in the UNIX System Administrator’s Guide. 
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ACCTCMS(IM) 


ACCTCMS(IM) 


NAME 

acctcms - command summary from per-process accounting records 

SYNOPSIS 

/usr/lib/acct/acctcms [options] files 

DESCRIPTION 

Acctcms reads one or more files, normally in the form described in acct(4). It adds all records for processes 
that executed identically-named commands, sorts them, and writes them to the standard output, normally 
using an internal summary format. The options are: 

-a Print output in ASCII rather than in the internal summary format. The output includes command 
name, number of times executed, total kcore-minutes, total CPU minutes, total real minutes, mean 
size (in K), mean CPU minutes per invocation, and “hog factor”, as in accfcom(l). Output is nor¬ 
mally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under Mother’ ’. 

-n Sort by number of command invocations. 

-s Any file names encountered hereafter are already in internal summary format. 

A typical sequence for performing daily command accounting and for maintaining a running total is: 

acctcms file ... >today 

cp total previoustotal 

acctcms -s today previoustotal >total 

acctcms -a -s today 

SEE ALSO 

acct(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(4), utmp(4). 
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ACCTCON(IM) 


ACCTCON(IM) 


NAME 

acctconl, acctcon2 - connect-time accounting 

SYNOPSIS 

/usr/lib/acct/acctconl [options] 

/usr/lib/acct/acctcon2 

DESCRIPTION 

Acctconl converts a sequence of login/logoff records read from its standard input to a sequence of records, 
one per login session. Its input should normally be redirected from /etc/wtmp. Its output is ASCII, giving 
device, user ID, login name, prime connect time (seconds), non-prime connect time (seconds), session start¬ 
ing time (numeric), and starting date and time. The options are: 

-p Print input only, showing line name, login name, and time (in both numeric and date/time formats), 

-t Acctconl maintains a list of lines on which users are logged in. When it reaches the end of its 

input, it emits a session record for each line that still appears to be active. It normally assumes that 
its input is a current file, so that it uses the current time as the ending time for each session still in 
progress. The -t flag causes it to use, instead, the last time found in its input, thus assuring reason¬ 
able and repeatable numbers for non-current files. 

-\file File is created to contain a summary of line usage showing line name, number of minutes used, per¬ 
centage of total elapsed time used, number of sessions charged, number of logins, and number of 
logoffs. This file helps track line usage, identify bad lines, and And software and hardware oddities. 
Hang-up, termination of login{\) and terminiation of the login shell generate a logoff records, so 
that the number of logoffs is often three to four times the number of sessions. See init{\M) and 
utmp(4). 

-ofile File is Ailed with an overall record for the accounting period, giving starting time, ending time, 
number of reboots, and number of date changes. 

Acctcon2 expects as input a sequence of login session records and converts them into total accounting 
records (see tacct format in acct(4)). 

EXAMPLES 

These commands are typically used as shown below. The Ale ctmp is created only for the use of 
acctprc(lM) commands: 

acctconl -t -1 lineuse -o reboots <wtmp I sort H-ln h- 2 >ctmp 
acctcon2 <ctmp I acctmerg >ctacct 

EILES 

/etc/wtmp 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(4), utmp(4). 

BUGS 

The line usage report is confused by date changes. Use wtmpfix {seefwtmp{lM)) to correct this situation. 
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ACCTMERG(IM) 


ACCTMERG(IM) 


NAME 

acctmerg - merge or add total accounting files 

SYNOPSIS 

/usr/lib/acct/acctmerg [options] [file] ... 

DESCRIPTION 

Acctmerg reads its standard input and up to nine additional files, all in the facet format (see acct(4)), or an 
ASCII version thereof. It merges these inputs by adding records whose keys (normally user ID and name) 
are identical, and expects the inputs to be sorted on those keys. Options are: 

-a Produce output in ASCII version of tacct. 

-i Input files are in ASCII version of tacct. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-V Produce output in verbose ASCII format, with more precise notation for floating point numbers. 

The following sequence is useful for making ‘ ‘repairs’ ’ to any file kept in this format: 

acctmerg -v <filel >file2 

edit file! as desired ... 
acctmerg -a <file2 >filel 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctprc(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(4), utmp(4). 
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ACCTPRC(IM) 


ACCTPRC(IM) 


NAME 

acctprc 1, acctprc2 - process accounting 

SYNOPSIS 

/usr/lib/acct/acctprcl [ctmp] 

/usr/lib/acct/acctprc2 

DESCRIPTION 

Acctprcl reads input in the form described by acct{A), adds login names corresponding to user IDs, then 
writes for each process an ASCII line giving user ID, login name, prime CPU time (tics), non-prime CPU 
time (tics), and mean memory size (in 64-byte units). If ctmp is given, it is expected to contain a list of 
login sessions, in the form described in accfcon(lM), sorted by user ID and login name. If this file is not 
supplied, it obtains login names from the password file. The information in ctmp helps it distinguish 
among different login names that share the same user ID. 

Acctprcl reads records in the form written by acctprcl , summarizes them by user ID and name, then writes 
the sorted summaries to the standard output as total accounting records. 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct I acctprc2 >ptacct 

PILES 

/etc/passwd 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(4), utmp(4). 

BUGS 

Although it is possible to distinguish among login names that share user IDs for commands run normally, it 
is difficult to do this for those commands run from cron(lM), for example. More precise conversion can be 
done by faking login sessions on the console via the acctwtmp program in accf(lM). 
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ACCTSH(IM) 


ACCTSH(IM) 


NAME 

chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp, prdaily, prtacct, mnacct, shutacct, startup, 
turnacct - shell procedures for accounting 

SYNOPSIS 

/usr/lib/acct/chargefee login-name number 
/usr/lib/acct/ckpacct [blocks] 

/usr/lib/acct/dodisk 
/usr/lib/acct/lastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/acct/prctmp 
/usr/lib/acct/prdaily [ mmdd ] 

/usr/lib/acct/prtacct file [ "heading" ] 

/usr/lib/acct/runacct [mmdd] [mmdd state] 

/usr/lib/acct/shutacct [ "reason" ] 

/usr/lib/acct/startup 
/usr/lib/acct/turnacct on I off I switch 
DESCRIPTION 

Chargefee can be invoked to charge a number of units to login-name. A record is written to /usr/adm/fee, 
to be merged with other accounting records during the night. 

Ckpacct should be initiated via cron{\M). It periodically checks the size of /usr/adm/pacct. If the size 
exceeds blocks, 1000 by default, turnacct will be invoked with argument switch. If the number of free disk 
blocks in the /usr file system falls below 500, ckpacct will automatically turn off the collection of process 
accounting records via the off argument to turnacct. When at least this number of blocks is restored, the 
accounting will be activated again. This feature is sensitive to the frequency at which ckpacct is executed, 
usually by cron. 

Dodisk should be invoked by cron to perform the disk accounting functions. 

Lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, which shows the last date on 
which each person logged in. 

Monacct should be invoked once each month or each accounting period. Number indicates which month or 
period it is. If number is not given, it defaults to the current month (01-12). This default is useful if 
monacct is to executed via cron (IM) on the first day of each month. Monacct creates summary files in 
/usr/adm/acct/flscal and restarts summary files in /usr/adm/acct/sum. 

Nulladm creates with mode 664 and insures owner and group are adm. It is called by various account¬ 
ing shell procedures. 

Prctmp can be used to print the session record file (normally /usr/adm/acct/nite/ctmp created by acctconl 
(see accfcon (IM)). 

Prdaily is invoked by runacct to format a report of the previous day’s accounting data. The report resides 
in /usr/adm/acct/sum/rprtmmfiffif where mmdd is the month and day of the report. The current daily 
accounting reports may be printed by typing prdaily. Previous days’ accounting reports can be printed by 
using the mmdd option and specifying the exact report date desired. Previous daily reports are cleaned up 
and therefore inaccessible after each invocation of monacct. 

Prtacct can be used to format and print any total accounting (tacct) file. 
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ACCTSH(IM) 


ACCTSH(IM) 


Runacct performs the accumulation of connect, process, fee, and disk accounting on a daily basis. It also 
creates summaries of command usage. For more information, see runacct(lM). 

Shutacct should be invoked during a system shutdown (usually in /etc/shutdown) to turn process account¬ 
ing off and append a ‘ ‘reason’ ’ record to /etc/wtmp. 

Startup should be called by /etc/rc to turn the accounting on whenever the system is brought up. 

Turnacct is an interface to accton (see acct{\M)) to turn process accounting on or off. The switch argu¬ 
ment turns accounting off, moves the current /usr/adm/pacct to the next free name in /usr/adm/pacct/ncr 
(where incr is a number starting with 1 and incrementing by one for each additional pacct file), then turns 
accounting back on again. This procedure is called by ckpacct and thus can be taken care of by the cron 
and used to keep pacct to a reasonable size. 

FILES 

/usr/adm/fee 
/usr/adm/pacct 
/usr/adm/pacct* 

/etc/wtmp 
/usr/adm/acct/nite 
/usr/lib/acct 

/usr/adm/ acct/sum 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(4), utmp(4). 


accumulator for fees 

current hie for per-process accounting 

used if pacct gets large and during 

execution of daily accounting procedure 

login/logoff summary 

working directory 

holds all accounting commands listed in 
sub-class IM of this manual 
summary directory, should be saved 
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ACUSET(IM) 


(3B20S only) 


ACUSET(IM) 


NAME 

acuset - connect ACUs and communication lines 

SYNOPSIS 

/etc/acuset filen 

DESCRIPTION 

The acuset command provides a means for dynamically associating UN56 ACU minor devices with com¬ 
munication lines. The connections are specified in filen', the format of this file is described below. Until 
these connections have been made, a program cannot dial out on an ACU. The connections can be changed 
dynamically. The only processes affected are those trying to dial out on the connections being changed. 

Filen consists of one or more lines of the following form: 

/dev/acu? unit port [ line ] 

where /dev/acu? is the ACU device name, unit is the ACU unit number, port is the port number, and line is 
the line number in an ACU sharing arrangement. A non-shared ACU does not have a line number. 

Here is a sample file for four ACUs with no sharing arrangements. 

/dev/acuO 0 0 
/dev/acul 0 1 
/dev/acu2 0 2 
/dev/acu3 0 3 

Here is a sample file for one ACU in a sharing arrangement with twelve data sets. 

/dev/acuO 0 0 1 
/dev/acul 0 0 2 
/dev/acu2 0 0 3 
/dev/acu3 0 0 4 
/dev/acu4 0 0 5 
/dev/acu5 0 0 6 
/dev/acu6 0 0 7 
/dev/acu7 0 0 8 
/dev/acu8 0 0 9 
/dev/acu9 0 0 10 
/dev/aculO 0 0 11 
/dev/acu 11 0 0 12 

Non-shared and shared ACUs may be attached to different ports of a single UN56. 

SEE ALSO 

acu(7). 
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ATB(IM) 


(3B20S only) 


ATB(IM) 


NAME 

atb - attach to an Address Translation Buffer 
SYNOPSIS 

/etc/atb command args 
DESCRIPTION 

An Address Translation Buffer (ATB) is an associative memory that is used to speed up the conversion of a 
virtual memory address to a physical memory address. The 3B20S contains eight ATBs. ATB-0 is used by 
the operating system, ATB-1 is shared by all user processes, ATB-2 through ATB-7 are normally unused. 

The atb command “attaches” itself to an unused ATB, i.e. becomes the sole process using it, and then over¬ 
lays itself with command. A process “attached to” an ATB will run slightly faster if measured over a long 
period of time. 

WARNING 

Super-user privileges are required. 

SEE ALSO 

sys3b(2). 
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BCOPY(IM) 


(Obsolescent) 


BCOPY(IM) 


NAME 

bcopy - interactive block copy 

SYNOPSIS 

/etc/bcopy 

DESCRIPTION 

Bcopy dates from a time when neither the UNIX System file nor the DEC disk drives were as reliable as they 
are now. Bcopy copies from and to files starting at arbitrary block (512-byte) boundaries. 

The following questions are asked; 

to: (you name the file or device to be copied to), 

offset: (you provide the starting “to” block number), 
from: (you name the file or device to be copied from), 
offset: (you provide the starting “from” block number), 
count: (you reply with the number of blocks to be copied). 

After count is exhausted, the from question is repeated (giving you a chance to concatenate blocks at the 
toH-offset-HCOunt location). If you answer from with a carriage return, everything starts over. 

Two consecutive carriage returns terminate bcopy. 

SEE ALSO 

cpio(l), dd(l). 
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BRC(IM) 


BRC(IM) 


NAME 

brc, bcheckrc, rc, powerfail - system initialization shell scripts 

SYNOPSIS 

/etc/brc 

/etc/bcheckrc 

/etc/rc 

/etc/powerfail 

DESCRIPTION 

Except for powerfail, these shell procedures are executed via entries in /etc/inittab by init{\M) when the 
system is changed out of SINGLE USER mode. Powerfail is executed whenever a system power failure is 
detected. 

The brc procedure clears the mounted file system table, /etc/mnttab (see mnttab{4)), and loads any pro¬ 
grammable micro-processors with their appropriate scripts. 

The bcheckrc procedure performs all the necessary consistency checks to prepare the system to change into 
multi-user mode. It will prompt to set the system date and to check the file systems with/icA:(lM). 

The rc procedure starts all system daemons before the terminal lines are enabled for multi-user mode. In 
addition, file systems are mounted and accounting, error logging, system activity logging and the Remote 
Job Entry (RJE) system are activated in this procedure. 

The powerfail procedure is invoked when the system detects a power failure condition. Its chief duty is to 
reload any programmable micro-processors with their appropriate scripts, if appropriate. It also logs the 
fact that a power failure occurred. 

These shell procedures, in particular rc may be used for several run-level states. The who(l) command may 
be used to get the run-level information. 

SEE ALSO 

init(lM), shutdown(lM), who(l), inittab(4), vpm(7). 
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NAME 

checkall - faster file system checking procedure 

SYNOPSIS 

/etc/checkall 

DESCRIPTION 

The checkall procedure is a prototype and must be modified to suit local conditions. The following will 
serve as a example: 

# check the root file system by itself 
fsck /dev/rpO 

# dual fsck of drives 0 and 1 
dfsck /dev/rrp[ 12345] - /dev/rrpll 

In the above example (where /dev/rrpll is 320K blocks and /dev/rrp[12345] are each 65K or less), a pre¬ 
vious sequential/ick took 19 minutes. The checkall procedure takes 11 minutes. 

Dfsck is a program that permits an operator to interact with two/ick/lM) programs at once. To aid in this, 
dfsck will print the file system name for each message to the operator. When answering a question from 
dfsck, the operator must prefix the response with a 1 or a 2 (indicating that the answer refers to the first or 
second file system group). 

Due to the file system load balancing required for dual checking, the dfsck command should always be exe¬ 
cuted through the checkall shell procedure. 

In a practical sense, the file systems are divided up as follows: 

dfsck file_systems_on_drive_0 - file_systems_on_drive_l 
dfsck file_systems_on_drive_2 - file_systems_on_drive_3 

A three drive system can be handled by this more concrete example (assumes two large file systems per 
drive): 

dfsck /dev/dsk31 /dev/dsk[14] - /dev/dskl[14] /dev/dsk34 

Note that the first drive 3 file system is first in filesystems 1 list and is last in Xht filesystems! list assuring 
that references to that drive will not overlap at execution time. 

WARNINGS 

1. Do not use dfsck to check the root file system. 

2. On a check that requires a scratch file (see -t above), be careful not to use the same temporary file for 
the two groups (this is sure to scramble the file systems). 

3. The dfsck procedure is useful only if the system is set up for multiple physical I/O buffers. 

SEE ALSO 

fsck(lM). 

Setting up the UNIX System in the UNIX System Administrator’s Guide. 
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NAME 

chmap - change the diagnostic spooler map file 

SYNOPSIS 

/dgn/bin/chmap 

DESCRIPTION 

Chmap informs the on-line diagnostic spooler to reread the spooler map file. The spooler map file, 
/dgn/dgnc/map, contains a list of at most 10 file names. Each file name is contained on a separate line. All 
diagnostic output messages will be appended to each file that is specified within the map file. If the first 
line of the map file is the character string stamp, then all diagnostic output messages are prefixed with a 
time stamp. 

PILES 

/dgn/dgnc/map 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 
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NAME 

chroot - change root directory for a command 

SYNOPSIS 

/etc/chroot newroot command 
DESCRIPTION 

The given command is executed relative to the new root. The meaning of any initial slashes (/) in path 
names is changed for a command and any of its children to newroot. Furthermore, the initial working 
directory is newroot. 

Notice that: 

chroot newroot command >x 

will create the file x relative to the original root, not the new one. 

This command is restricted to the super-user. 

The new root path name is always relative to the current root: even if a chroot is currently in effect, the 
newroot argument is relative to the current root of the running process. 

SEE ALSO 

chdir(2). 

BUGS 

One should exercise extreme caution when referencing special files in the new root file system. 
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NAME 

clri - clear i-node 
SYNOPSIS 

/etc/clri file-system i-number... 

DESCRIPTION 

Clri writes zeros on the 64 bytes occupied by the i-node numbered i-number. File-system must be a special 
file name referring to a device containing a file system. After clri is executed, any blocks in the affected 
file will show up as “missing” in an/icA:(lM) of file-system. This command should only be used in 
emergencies and extreme care should be exercised. 

Read and write permission is required on the specifieddevice. The i-node becomes allocatable. 

The primary purpose of this routine is to remove a file which for some reason appears in no directory. If it 
is used to zap an i-node which does appear in a directory, care should be taken to track down the entry and 
remove it. Otherwise, when the i-node is reallocated to some new file, the old entry will still point to that 
file. At that point removing the old entry will destroy the new file. The new entry will again point to an 
unallocated i-node, so the whole cycle is likely to be repeated again and again. 

SEE ALSO 

fsck(lM), fsdb(lM), ncheck(lM), fs(4). 

BUGS 

If the file is open, clri is likely to be ineffective. 
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CONFIG (IM) 


NAME 

config - configure a UNIX System 

SYNOPSIS 

/etc/config [ system [ master ] ] 

DESCRIPTION 

Config is a program that takes a description of a UNIX system and generates the necessary configuration 
information for the operating system. This includes hardware, driver and parameter specifications. System 
is used for the description file. The default file is /etc/system. Information defining the allowable 
configuration is kept in the master file. The default file is /etc/master. 

The user must supply the system definition file; the supplied version contains the minimal configuration for 
the processor. 

PILES 

/etc/system 
/etc/master 
conf.c 

SEE ALSO 

sysdef(lM), master(4), system(4). 

Setting up the UNIX System in the UNIX System Administrator’s Guide. 

DIAGNOSTICS 

Diagnostics are routed to the standard error output and are self-explanatory. 


default system description file 
default input master device table 
output configuration table file 
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CONFIG (IM) 


NAME 

config - configure a UNIX System 

SYNOPSIS 

/etc/config [ -n ] [ -t ] [ -1 file ] [ -c file ] [ -m file ] dfile 
DESCRIPTION 

Config is a program that takes a description of a UNIX system and generates two files. One file provides 
information regarding the interface between the hardware and device handlers. The other file is a C pro¬ 
gram dehning the configuration tables for the various devices on the system. 

The -n option produces a non-separated I and 
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CRASH (IM) 


NAME 

crash - examine system images 

SYNOPSIS 

/etc/crash [ system ] [ namelist ] 

DESCRIPTION 

Crash is an interactive utility for examining an operating system core image. It has facilities for interpret¬ 
ing and formatting the various control structures in the system and certain miscellaneous functions that are 
useful when perusing a dump. 

The arguments to crash are the file name where the system image can be found and a namelist file to be 
used for symbol values. 

The default values are /dev/mem and /unix; hence, crash with no arguments can be used to examine an 
active system. If a system image file is given, it is assumed to be a system core dump and the default pro¬ 
cess is set to be that of the process running at the time of the crash. This is determined by a value stored in 
a fixed location by the dump mechanism. 

COMMANDS 

Input to crash is typically of the form: 

command [ options ] [ structures to be printed ]. 

When allowed, options will modify the format of the printout. If no specific structure elements are 
specified, all valid entries will be used. As an example, proc - 12 15 3 would print process table slots 12, 
15 and 3 in a long format, while proc would print the entire process table in standard format. 

In general, those commands that perform I/O with addresses assume hexadecimal on 32-bit machines and 
octal on 16-bit machines. 

The current repertory consists of: 

user [ list of process table entries ] 

Aliases: uarea, u area, u. 

Print the user structure of the named process as determined by the information contained in the 
process table entry. If no entry number is given, the last executing process’s information will be 
printed. Swapped processes produce an error message. 

trace [-r] [ list of process table entries ] 

Aliases: t. 

Generate a kernel stack trace of the current process. If the -r option is used, the trace begins at the 
saved stack frame pointer in kfp. Otherwise the trace starts at the bottom of the stack and attempts 
to find valid stack frames deeper in the stack. If no entry number is given, the last executing 
process’s information will be printed. 

kfp [ stack frame pointer ] 

Aliases: r5, fp. 

Print the program’s idea of the start of the current stack frame (set initially from a fixed location in 
the dump) if no argument is given, or set the frame pointer to the supplied value. 

stack [ list of process table entries ] 

Aliases: stk, s, kernel, k. 

Format a dump of the kernel stack of a process. The addresses shown are virtual system data 
addresses rather than true physical locations. If no entry number is given, the last executing 
process’s information will be printed. 

proc [ -[r] ] [ list of process table entries ] 

Aliases: ps, p. 

Format the process table. The -r option causes only runnable processes to be printed. The - alone 
generates a longer listing. 
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pcb [ list of process table entries ] 

Print the process control block of the current process. The process control block is a part of the 
user area (VAX-11/780 only). If no entry number is given, the last executing process’s informa¬ 
tion will be printed. 

inode [ - ] [ list of inode table entries ] 

Aliases: ino, i. 

Format the inode table. The - option will also print the inode data block addresses. 

file [ list of hie table entries ] 

Aliases: files, f. 

Format the file table. 

mount [ list of mount table entries ] 

Aliases: mnt, m. 

Format the mount table. 

text [ list of text table entries ] 

Aliases: txt, x. 

Format the text table. 

tty [ type ] [ - ] [ list of tty entries ] 

Aliases: term, dz, dh. 

Print the tty structures. The type argument determines which structure will be used (such as kl, 
dh, dz, or dzb; the last type is remembered). The - option prints the sffy(l) parameters for the 
given line. 

stat Print certain statistics found in the dump. These include the panic string (if a panic occurred), time 
of crash, system name, and the registers saved in low memory by the dump mechanism. 

var Aliases: tunables, tunable, tune, v. 

Print the tunable system parameters. 

buf [ list of buffer headers ] 

Aliases: hdr, bufhdr. 

Format the system buffer headers. 

buffer [ format ] [ list of buffers ] 

Alias: b. 

Print the data in a system buffer according to format. \f format is omitted, the previous/ormaf is 
used. Valid formats include decimal, octal, hex, character, byte, directory, inode, and write. 
The last creates a file in the current directory (see FILES) containing the buffer data. 

callout Aliases: calls, call, c, timeout, time, tout. 

Print all entries in the callout table. 

map [ list of map names ] 

Format the named system map structures. 

nm [ list of symbols ] 

Print symbol value and type as found in the namelist file, 
ts [ list of text addresses ] 

Find the closest text symbols to the given addresses. 

ds [ list of data addresses ] 

Find the closest data symbols to the given addresses. 

od [ symbol name or address ] [ count ] [ format ] 

Aliases: dump, rd. 

Dump count data values starting at the symbol value or address given according to format. 
Allowable formats are octal, longoct, decimal, longdec, character, hex, or byte. 
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! Escape to shell, 

q Exit from crash. 

? Print synopsis of commands. 

ALIASES 

There are built in aliases for many of the formats as well as those listed for the commands. Some of them 
are: 


byte 

b. 

character 

char, c. 

decimal 

dec, e. 

directory 

direct, dir, d. 

hexadecimal hexadec, hex, h, x. 

inode 

ino, i. 

longdec 

Id, D. 

longoct 

lo, O. 

octal 

oct, o. 

write 

w. 


FILES 

/usr/include/sys/* h header files for table and structure info 
/dev/mem default system image file 

/unix default namelist file 

buf.# files created containing buffer data 

SEE ALSO 

mount(lM), nm(l), ps(l), sh(l), stty(l), crash(8). 

BUGS 

Most flags are abbreviated and will have little meaning to the uninitiated user. A source listing of the sys¬ 
tem header files at hand would be most useful while using crash. 

Stack tracing of the current process on a running system doesn’t work. 
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NAME 

cron - clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times according to the instructions in the file 
/usr/lib/crontab. Because cron never exits, it should be executed only once. This is best done by running 
cron from the initialization process through the file /etc/rc (see init{lM)). 

The file crontab consists of lines of six fields each. The fields are separated by spaces or tabs. The first 
five are integer patterns that specify in order: 
minute (0-59), 
hour (0-23), 

day of the month (1-31), 
month of the year (1-12), 
and day of the week (0-6, with 0=Sunday). 

Each of these patterns may contain: 

a number in the (respective) range indicated above; 

two numbers separated by a minus (indicating an inclusive range); 

a list of numbers separated by commas (meaning all of these numbers); or 

an asterisk (meaning all legal values). 

The sixth field is a string that is executed by the shell at the specified time(s). A % in this field is translated 
into a new-line character. Only the first line (up to a % or the end of line) of the command field is executed 
by the shell. The other lines are made available to the command as standard input. 

Cron examines crontab once a minute to see if it has changed; if it has, cron reads it. Thus it takes only a 
minute for entries to become effective. 

PILES 

/usr/lib/crontab 

/usr/adm/cronlog 

SEE ALSO 

init(lM), sh(l). 

DIAGNOSTICS 

A history of all actions by cron are recorded in /usr/adm/cronlog. 

BUGS 

Cron reads crontab only when it has changed, but it reads the in-core version of that table once a minute. 
A more efficient algorithm could be used. The overhead in running cron is about one percent of the CPU, 
exclusive of any commands executed by cron. 


Page 1 



DCOPY(IM) 


DCOPY(IM) 


NAME 

dcopy - copy file systems for optimal access time 

SYNOPSIS 

/etc/dcopy [-sX] [-an] [-d] [-v] [-ffsizerisize] inputfs outputfs 
DESCRIPTION 

Dcopy copies file system inputfs to outputfs. Inputfs is the existing file system; outputfs is an appropriately 
sized file system, to hold the reorganized result. For best results inputfs should be the raw device and 
outputfs should be the block device. Dcopy should be run on unmounted hie systems (in the case of the 
root hie system, copy to a new pack). With no arguments, dcopy copies hies from inputfs compressing 
directories by removing vacant entries, and spacing consecutive blocks in a hie by the optimal rotational 
gap. The possible options are 

-sX supply device information for creating an optimal organization of blocks in a hie. The forms 

of X are the same as the -s option of/icA:(lM). 

-an place the hies not accessed in n days after the free blocks of the destination hie system (default 

for n is 7). If no n is specihed then no movement occurs. 

-d leave order of directory entries as is (default is to move sub-directories to the beginning of 

directories). 

-V currently reports how many hies were processed, and how big the source and destination freel¬ 

ists are. 

-ffsize[:isize] 

specify the outputfs hie system and inode list sizes (in blocks). If not given, the values from 
the inputfs are used. 

Dcopy catches interrupts and quits and reports on its progress. To terminate dcopy, send a quit signal and 
dcopy will no longer catch interrupts or quits. Dcopy also attempts to modify its command line arguments 
so its progress can be monitored withpi(l). 

SEE ALSO 

fsck(lM), mkfs(lM), ps(l). 
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NAME 

devnm - device name 

SYNOPSIS 

/etc/devnm [ names ] 

DESCRIPTION 

Devnm identifies the special file associated with the mounted hie system where the argument name resides 
(as a special case, both the block device name and the swap device name is printed for the argument name / 
if swapping is done on the same disk section as the root hie system). Argument names must be full path 
names. 

This command is most commonly used by /etc/rc (see bcheckrc{\M)) to construct a mount table entry for 
the root device. 

EXAMPLE 

The command; 

/etc/devnm /usr 

produces 

rpl /usr 

if /usr is mounted on /dev/rpl. 

EILES 

/dev/rp*, /dev/dsk* 

/etc/mnttab 

SEE ALSO 

bcheckrc(lM), setmnt(lM). 
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NAME 

df - report number of free disk blocks 
SYNOPSIS 

df [ -t ] [ -f ] [ file-systems ] 

DESCRIPTION 

Df prints out the number of free blocks and free i-nodes available for on-line file systems by examining the 
counts kept in the super-blocks; may be specified either by device name (e.g., /dev/dskl) or by 

mounted directory name (e.g., /usr). If iht file-systems argument is unspecihed, the free space on all of the 
mounted hie systems is printed. 

The -t hag causes the total allocated block hgures to be reported as well. 

If the -f hag is given, only an actual count of the blocks in the free list is made (free i-nodes are not 
reported). With this option, c/f will report on raw devices. 

PILES 

/dev/dsk* 

/etc/mnttab 

SEE ALSO 

fs(4), mnttab(4). 
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NAME 

dgn - initiate on-line diagnostics 
SYNOPSIS 

/dgn/bin/dgn name unit [ options ] 


DESCRIPTION 

Dgn initiates on-line diagnostics on the device indicated by name and unit. Options is a string of keyword 
parameters separated from each other by white space. Dgn parses the parameter string options and verifies 
that each keyword parameter does not contain any missing components or values that are out-of-range. 

The following options are recognized, each as a separate argument: 


Print the diagnostic results of every phase and all failures. By default, only the final results 
and the first five failures of each failing phase will be printed. 

Unconditionally execute the diagnostic with no early termination (i.e., the diagnostic will be 
run to completion in spite of failures). By default, the diagnostic will terminate after the 
first failing phase. 

Execute only the specified phase numbers. May be either a single decimal number or a 
range of numbers. The letter x denotes the beginning phase number and y the ending phase 
number. 

Repeats the diagnostic x times. The maximum value allowed is 256. 

Executes the Trouble Location Procedure at the conclusion of the diagnostic. This process 
analyzes diagnostic failures and generates a weighted list of faulty circuit packs. This 
option must not be used in conjunction with the ucl option. 

Me=filename Routes all output messages into a file named filename, instead of the user’s terminal. File¬ 
name is opened for appending and is relative to the directory /dgn/dgnc unless a full path¬ 
name is specified. 

cont This option is effective only when name and unit is an lOP By default, after an lOP is diag¬ 

nosed, all of its Peripheral Controllers (PCs) are diagnosed automatically. The cont option 
causes only the lOP diagnostics to be run. Note that MHDs are never automatically diag¬ 
nosed when name and unit is a DFC. 

hu =name unit 


raw 

ucl 

ph=x[-y] 

rpt=x 

tip 


This option allows a helper unit identified by name and unit to be specified. Eor example, 
when diagnosing the magnetic tape controller (i.e., UN32), a diagnostic test tape with a write 
ring must be mounted on the specified helper unit. The following example shows how one 
might invoke diagnostics using the helper unit option: 
dgn un32 0 ph=5 hu=mt 2 

SEE ALSO 


rmv(lM), rst(lM). 

3B DMERT Output Messages, OM-4C000-01. 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 
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NAME 

don, doff, disp - device logically on, logically off or display status 
SYNOPSIS 

/etc/don unit unitnum [ pump-file ] 

/etc/don all [ sysfile ] 

/etc/doff unit unitnum 

/etc/disp unit unitnum 
/etc/disp all [ sysfile ] 

/etc/disp all - [ sysfile ] 

/etc/disp all -i [ sysfile ] 

/etc/disp all -c [ incr ] [ sysfile ] 

DESCRIPTION 

Don restores to service (logically connects to the system) a hardware unit. Unitnum is the unit number of 
that particular wn/f. For example, 

don tn4 1 

restores to service the tn4 whose unit number is 1. Pump-file in directory /firm is pumped into that 
specified device. The default pump-file is unit. Don all reads sysfile, default is /etc/system, and performs 
a don unit unitnum [pump-file] on each lOP, DFC and associated peripherals listed in that file. Lines 
prefixed with a # (comment) or ! (no-pump) will be skipped. Don all is primarily useful when the system is 
brought to multi-user mode. 

removes from service (logically disconnects) unitnum of type unit. 

Disp prints the status of unitnum of type unit (e.g., “out of service”, “undergoing diagnostics”). Disp all 
reads sysfile, default is /etc/system, and performs a disp unit unitnum on each lOP, DFC and associated 
peripherals listed in that file. Lines prefixed with a # are skipped. Output is in the form of; 

unit-unitnum chan dev status 

for an lOP or DFC and 

slot unit-unitnum status 

for each device on that lOP or DFC. If the - argument is given, a status diagram of the hardware is printed 
on the terminal. Known terminals from the environment parameter $TERM (see environ{5)) are: 

$TERM Value Terminal Type 
4420 TTY 4420 

vtlOO VT 100 

2621 HP 2621 

2645 HP 2645 

Peripherals out of service are displayed in inverse video and invalid entries are blinked (shown by * and I, 
respectively, under the device slot on Hewlett Packard terminals). The i flag makes the program interac¬ 
tive; the c flag redraws the status of the machine every incr seconds, default is 30 (a ? is printed under each 
entry that has changed status since the invocation of the program). 

FILES 

/etc/master default table for hardware specifications 
/etc/system default system configuration file 

SEE ALSO 

conflg(lM), master(4), system(4). 
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NAME 

dskfmt, dskvfy - format and verify disk packs 

SYNOPSIS 

/etc/dskfmt unit [ start [ end ] ] 

/etc/dskvfy unit [ start [ end ] ] 

DESCRIPTION 

Dskfmt formats a disk pack and dskvfy verifies the format of a disk pack. Unit specifies the unit number of 
the disk drive to be used. Note that this drive must be in the out of service state and the controller for this 
drive must be in the in service state. Start and end specify the starting and ending cylinders, inclusive, for 
the operation to be done. If no arguments are given the default for start is 0 and for end is the last cylinder 
on the disk. 

PILES 

/dev/dgn/mhd 

/dev/dgn/dfc 

SEE ALSO 

dsk(7). 

DIAGNOSTICS 

If dskvfy hnds an error in the format of the disk the numbers of the cylinders found to be bad will be 
printed. 
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NAME 

dstart, dstop, dstat - start, stop and find status of on-line diagnostics 

SYNOPSIS 

/dgn/bin/dstart 

/dgn/bin/dstop 

/dgn/bin/dstat 

DESCRIPTION 

Dstart enables on-line diagnostics to be run by automatically starting both the Output Message Spooler 
Program (SPOOLER) and the Maintenance Request Input Administrator Program (MIRA), respectively. 
These two diagnostics programs are only started if they’re not already running. Also, both program’s pro¬ 
cess ID numbers are reported in parentheses. On-line diagnostics require that both these programs be 
started before any diagnostics requests are accepted. 

The spooler arranges for all diagnostic output to be logged in /dgn/dgnc/log. When the spooler is restarted, 
/dgn/dgnc/log is moved to /dgn/dgnc/oldlog and a new /dgn/dgnc/log is started. All output is also 
appended to each file mentioned in the map file, /dgn/dgnc/map (see chmap{\M)). 

Dstop stops both the SPOOLER and MIRA programs only if they are currently running. Otherwise, no 
explicit action is taken. In either case, an appropriate message is reported indicating what action did occur. 

Dstat reports the current status of both the SPOOLER and MIRA diagnostic programs. If both programs are 
currently running a message indicating that they are running is reported along with their respective process 
ID numbers. Otherwise, a message indicating that they are not running is reported. 

EILES 

/dgn/dgnc/log spooler output message log. 

/dgn/dgnc/map list of file names for routing spooler output messages. 

SEE ALSO 

dgn(lM), rmv(lM), rst(lM). 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 
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NAME 

emulcntrl - perform 3270 emulation control functions 
SYNOPSIS 

/etc/emulcntrl device function [ arg ] 

DESCRIPTION 

Emulcntrl is used to communicate with the 3270 emulation controller driver. Device is the name of the 
emulation controller to use (e.g., /dev/emcO). Function is a string indicating the operation to perform. 
Some functions require an additional argument arg. Valid function strings and additional arguments are as 
follows: 

on Start the 3270 emulation script associated with device. 

off Stop the 3270 emulation script associated with device. 

ascii This 3270 emulation controller is to be ASCII. The ASCII 3270 script must be loaded on the asso¬ 
ciated physical device. 

ebcdic This 3270 emulation controller is to be EBCDIC. The EBCDIC 3270 script must be loaded on the 
associated physical device. Controllers are EBCDIC by default. 

pollid Change the POLL character for this controller to arg. Arg must be the decimal value of the charac¬ 
ter desired. 

selid Change the SELECT character for this controller to arg. Arg must be the decimal value of the 
character desired. 

delay Set the time delay before transmitting EOT’s to argHO seconds. The default is 2 seconds, 
trace Force the script to trace certain events. 

Except for starting and stopping, these functions should be performed before starting the script. 

PILES 

/dev/emc? 3270 emulation controller devices 

/lib/a3270scr ASCII 3270 script 

/lib/e3270scr EBCDIC 3270 script 

SEE ALSO 

emulload(lM), emulstat(lM), vpmset(lM), emulio(7). 

DIAGNOSTICS 

Emulcntrl fails if the function cannot be performed, e.g., changing the POLL character on a running con¬ 
troller. 
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NAME 

emulload - load and start 3270 emulation script 

SYNOPSIS 

/etc/emulload 

DESCRIPTION 

The emulload command file is used to load the 3270 emulation protocol script into the physical device, set 
the proper options, and start execution of the script. Emulload will need local modification to use the 
proper hardware device, set the proper options, or to start more than one emulation controller. 

As distributed, emulload contains the following: 

/etc/vpmset /dev/emcO /dev/un53.0 
/etc/emulcntrl /dev/emcO ascii 
/etc/vpmstart /dev/un53.0 6 /lib/a3270scr 
/etc/emulcntrl /dev/emcO on 

This command file will connect the emulation controller and physical line, set the controller to ASCII mode, 
load the ASCII emulation script, and start execution of the script. Other controller options are described in 
emulcntrl(\M). 

The /etc/rc file should call /etc/emulload when going to multi-user state. The /etc/shutdown file should 
halt any controllers that were started in /etc/rc. For example, the entry in /etc/shutdown for the emulload 
command shown above would be: 

/etc/emulcntrl /dev/emcO off 


PILES 

/dev/emc? 3270 emulation controller devices 

/lib/a3270scr ASCII 3270 script 

/lib/e3270scr EBCDIC 3270 script 

SEE ALSO 

emulcntrl(lM), emulstat(lM), vpmset(lM), emulio(7). 
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(3B20S only) 


EMULSTAT(IM) 


NAME 

emulstat - get 3270 emulation controller/terminal status 

SYNOPSIS 

/etc/emulstat device 

DESCRIPTION 

Emulstat reports the status of device. Device may be a 3270 emulation controller or terminal. The status is 
reported as hexadecimal values representing the following: 

flags The value of the device flags. Possible flag values for controllers or terminals are given in 

emulioil). 

code A value used by the driver for indicating certain error conditions or return values. 

station For terminals, this is the value of the station (controller) identification byte. For controllers, it 
is the value of the Polling byte used by the remote system. 

terminal For terminals, this is the value of the terminal identification byte. For controllers, it is the 
value of the Selection byte used by the remote system. 

dev This value indicates the physical hardware device being used by this controller (e.g., the un53 

minor device number). 

Emulstat will fail if the controller has not been started. 

FILES 

/dev/emc? 3270 emulation controller devices 

/dev/emt* 3270 emulation terminal devices 

/lib/a3270scr ASCII 3270 script 

/lib/e3270scr EBCDIC 3270 script 

SEE ALSO 

emulcntrl(lM), emulload(lM), vpmset(lM), emulio(7). 
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NAME 

errdead - extract error records from dump 

SYNOPSIS 

/etc/errdead dumpfile [ namelist ] 

DESCRIPTION 

When hardware errors are detected by the system, an error record that contains information pertinent to the 
error is generated. If the error-logging daemon errdemon(lM) is not active or if the system crashes before 
the record can be placed in the error file, the error information is held by the system in a local buffer. 
Errdead examines a system dump (or memory), extracts such error records, and passes them to errpt{\M) 
for analysis. 

The dumpfile specifies the file (or memory) that is to be examined. The system namelist is specified by 
namelist', if not given, /unix is used. 

PILES 

/unix system namelist 

/usr/bin/errpt analysis program 

/usr/tmp/errXXXXXX temporary file 

DIAGNOSTICS 

Diagnostics may come from either errdead or errpt. In either case, they are intended to be self- 
explanatory. 

SEE ALSO 

errdemon(lM), errpt(lM). 


Page 1 



ERRDEMON(IM) 


ERRDEMON(IM) 


NAME 

errdemon - error-logging daemon 
SYNOPSIS 

/usr/lib/errdemon [ file ] 

DESCRIPTION 

The error logging daemon errdemon collects error records from the operating system by reading the special 
file /dev/error and places them in file. If file is not specified when the daemon is activated, 
/usr/adm/errflle is used. Note that^fe is created if it does not exist; otherwise, error records are appended 
to it, so that no previous error data is lost. No analysis of the error records is done by errdemon-, that 
responsibility is left to errpt{\M). The error-logging daemon is terminated by sending it a software kill 
signal (see signal (2)). Only the super-user may start the daemon, and only one daemon may be active at 
any time. 

PILES 

/dev/error source of error records 

/usr/adm/errfile repository for error records 

DIAGNOSTICS 

The diagnostics produced by errdemon are intended to be self-explanatory. 

SEE ALSO 

errpt(lM), errstop(lM), kill(l), err(7). 
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NAME 

errpt - process a report of logged errors 

SYNOPSIS 

errpt [ options ] [ files ] 

DESCRIPTION 

Errpt processes data collected by the error logging mechanism {errdemon{\M)) and generates a report of 
that data. The default report is a summary of all errors posted in the files named. Options apply to all files 
and are described below. If no files are specified, errpt attempts to use /usr/adm/errfile as file. 

A summary report notes the options that may limit its completeness, records the time stamped on the earli¬ 
est and latest errors encountered, and gives the total number of errors of one or more types. Each device 
summary contains the total number of unrecovered errors, recovered errors, errors unabled to be logged, I/O 
operations on the device, and miscellaneous activities that occurred on the device. The number of times 
that errpt has difficulty reading input data is included as read errors. 

Any detailed report contains, in addition to specific error information, all instances of the error logging pro¬ 
cess being started and stopped, and any time changes (via date(l)) that took place during the interval being 
processed. A summary of each error type included in the report is appended to a detailed report. 

A report may be limited to certain records in the following ways: 

-s date Ignore all records posted earlier than date, where date has the form mmddhhmmyy, con¬ 

sistent in meaning with the date(l) command. 

-e date Ignore all records posted later than date, whose form is as described above. 

-a Produce a detailed report that includes all error types. 

-d devlist A detailed report is limited to data about devices given in devlist, where devlist can be 

one of two forms: a list of device identifiers separated from one another by a comma, or 

a list of device identifiers enclosed in double quotes and separated from one another by 
a comma and/or more spaces. Errpt is familiar with the common form of identifiers 
(e.g., rs03, RS04, hs; see Section 7 of this volume). For the 3B20S the devices for 
which errors are logged are DFC, lOP, and MT. For Digital Equipment Corporation 
machines, the (block) devices for which errors are logged are RP03, RP04, RP05, RP06, 
RP07, RS03, RS04, TSll, TUlO, TU16, TU78, RK05, RK06, RK07, RM05, RM80, and 
RFll. Additional identifiers are int and mem which include detailed reports of stray- 
interrupt and memory-parity type errors respectively. 

-p n Fimit the size of a detailed report to n pages. 

-f In a detailed report, limit the reporting of block device errors to unrecovered errors. 

FILES 

/usr/adm/errfile default error file 

SEE ALSO 

errdemon(lM), errfile(4). 
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NAME 

errstop - terminate the error-logging daemon 
SYNOPSIS 

/etc/errstop [ namelist ] 

DESCRIPTION 

The error-logging daemon errdemon(lM) is terminated by using errstop. This is accomplished by execut¬ 
ing pi(l) to determine the daemon’s identity and then sending it a software kill signal (see signal(2)y, /unix 
is used as the system namelist if none is specified. Only the super-user may use errstop. 

PILES 

/unix default system namelist 

DIAGNOSTICS 

The diagnostics produced by errstop are intended to be self-explanatory. 

SEE ALSO 

errdemon(lM), ps(l), kill(2). 
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NAME 

ff - list file names and statistics for a file system 
SYNOPSIS 

/etc/ff [options] special 


DESCRIPTION 

Ff reads the i-list and directories of the special file, assuming it to be a file system, saving i-node data for 
files which match the selection criteria. Output consists of the path name for each saved i-node, plus any 
other file information requested using the print options below. Output fields are positional. The output is 
produced in i-node order; fields are separated by tabs. The default line produced byj^is: 

path-name i-number 

With all options enabled, output fields would be; 
path-name i-number size uid 

The argument n in the option descriptions that follow is used as a decimal integer (optionally signed), 
where +n means more than n, -n means less than n, and n means exactly n. A day is defined as a 24 hour 
period. 


-I 

-1 

-p prefix 

-s 
-u 
-a n 
-m n 
-c n 
-nfile 

-i i-node-list 


Do not print the i-node number after each path name. 

Generate a supplementary list of all path names for multiply linked hies. 

The specihed prefix will be added to each generated path name. The default is .. 
Print the hie size, in bytes, after each path name. 

Print the owner’s login name after each path name. 

Select if the i-node has been accessed in n days. 

Select if the i-node has been modihed in n days. 

Select if the i-node has been changed in n days. 

Select if the i-node has been modihed more recently than the argument 
Generate names for only those i-nodes specihed in i-node-list. 


EXAMPLES 

To generate a list of the names of all hies on a specihed hie system: 
ff -I /dev/diskroot 


To produce an index of hies and i-numbers which are on a hie system and have been modihed in the last 24 
hours: 

ff -m -1 /dev/diskusr > /log/incbackup/usr/tuesday 

To obtain the path names for i-nodes 451 and 76 on a specihed hie system: 
ff -i 451,76 /dev/rrp7 

SEE ALSO 

hnc(lM), hnd(l), frec(lM), ncheck(lM). 

BUGS 

Only a single path name out of any possible ones will be generated for a multiply linked i-node, unless the 
-1 option is specihed. When -1 is specihed, no selection criteria apply to the names generated. All possible 
names for every linked hie on the hie system will be included in the output. 

On very large hie systems, memory may run out before does. 
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NAME 

filesave, tapesave - daily/weekly UNIX file system backup 

SYNOPSIS 

/etc/filesave.? 

/etc/tapesave 

DESCRIPTION 

These shell scripts are provided as models. They are designed to provide a simple, interactive operator 
environment for file backup. Filesave. ? is for daily disk-to-disk backup and tapesave is for weekly disk- 
to-tape. 

The suffix .? can be used to name another system where two (or more) machines share disk drives (or tape 
drives) and one or the other of the systems is used to perform backup on both. 

SEE ALSO 

shutdown(lM), volcopy(lM). 
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NAME 

fine - fast incremental backup 
SYNOPSIS 

fine [selection-criteria] file-system raw-tape 

DESCRIPTION 

Fine selectively copies the uvpvA file-system to the output raw-tape . The cautious will want to mount the 
input file-system read-only to insure an accurate backup, although acceptable results can be obtained in 
read-write mode. The tape must be previously labelled by labelit (see volcopy{\M)). The selection is con¬ 
trolled by the selection-criteria, accepting only those inodes/files for whom the conditions are true. 

It is recommended that production of a fine tape be preceded by the ff command, and the output of ff be 
saved as an index of the tape’s contents. Files on a fine tape may be recovered with the free command. 

The argument n in the selection-criteria which follow is used as a decimal integer (optionally signed), 
where H-n means more than n, -n means less than n, and n means exactly n. A day is defined as a 24 hours. 

-a n True if the file has been accessed in n days. 

-m n True if the file has been modified in n days. 

-c n True if the i-node has been changed in n days. 

-nfile True for any file which has been modified more recently than the argument 

EXAMPLES 

To write a tape consisting of all files from file-system /usr modified in the last 48 hours: 
fine -m -2 /dev/rdiskusr /dev/rtpO 

SEE ALSO 

cpio(l), ff(lM), frec(lM), volcopy(lM). 
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(VAX stand-alone only) 
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NAME 

format - format and/or check RP06 and RM05 disk packs 

DESCRIPTION 

Format will format new RP06 or RM05 packs and check used packs (with write inhibited). The program 
reports the location and type of errors encountered, including ECC correctable error burst sizes. 

EXECUTION 

The following example shows how to \os.A format on a VAX-11/780 with a UNIX updated floppy disc: 

»>r> 

HALTED AT nnnnnnnn 

»>B<cr> 

CPU HALTED 

INIT SEQ DONE 

HALT INST EXECUTED 

HALTED AT nnnnnnnn 

LOAD DONE, nnnnnnnnn BYTES LOADED 

$$ 

To execute format, type /stand/format after the standalone shell prompt $$. The formatter will print out 
its command vocabulary, and proceed inter-actively. If one wishes to format a pack on disk drive 1, for 
example, the command is dlf. The program will double check format requests, as pack contents will be 
destroyed. 

COMMANDS 

mn MBA with drive doing the format is n. (defaults to 0) 

d n drive with the pack to be formatted or checked is n. (drive number must be between 1 and 7) 

f format pack 

c check pack format 

q quit 

V print vocabulary 

R n set the error report level to n. 

X will tell you about the available report levels. 

The X command will explain the Report Level options the first time it is executed. Subsequent execution 
by the operator or by the program during error logging, will merely print the information defined by the 
current report level. 

FILES 

/stand/format 

SEE ALSO 

780ops(8). 
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NAME 

free - recover files from a backup tape 

SYNOPSIS 

/etc/frec [ -p path ] [ -f reqfile ] raw-tape i-number:name ... 

DESCRIPTION 

Free recovers files from the specified raw-tape backup tape written by volcopy{\M) or finc{\M), given 
their i-numbers. The data for each recovery request will be written into the file given by name . 

The -p option allows you to specify a default prefixing path different from your current working directory. 
This will be prefixed to any names that are not fully qualified, i.e. that do not begin with / or ./. If any 
directories are missing in the paths of recovery names they will be created. 

-p path Specifies a prefixing path to be used to fully qualify any names that do not start with / 

or./. 

-f reqfile Specifies a file which contains recovery requests. The format is i-number:newname, one 

per line. 

EXAMPLES 

To recover a file, i-number 1216 when backed-up, into a file named junk in your current working directory: 
free /dev/rmtO 1216:junk 

To recover files with i-numbers 14156, 1232, and 3141 into files /usr/sre/emd/a, /usr/sre/emd/b and 
/usr/joe/a.c: 

free -p /usr/src/cmd /dev/rmtO 14156:a 1232:b 3141:/usr/joe/a.c 

SEE ALSO 

cpio(l), ff(lM), finc(lM), volcopy(lM). 

BUGS 

While paving a path (i.e. creating the intermediate directories contained in a pathname) free can only 
recover inode fields for those directories contained on the tape and requested for recovery. 
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NAME 

fsck, dfsck - file system consistency check and interactive repair 

SYNOPSIS 

/etc/fsck [-y] [-n] [-sX] [-SX] [-t file] [-q] [-D] [-f] [ file-systems ] 

/etc/dfsck [ options 1 ] filsysl ... - [ options2 ] filsys2 ... 

DESCRIPTION 

Esck 

Fsck audits and interactively repairs inconsistent conditions for UNIX System files. If the file system is con¬ 
sistent then the number of files, number of blocks used, and number of blocks free are reported. If the file 
system is inconsistent the operator is prompted for concurrence before each correction is attempted. It 
should be noted that most corrective actions will result in some loss of data. The amount and severity of 
data lost may be determined from the diagnostic output. The default action for each consistency correction 
is to wait for the operator to respond yes or no. If the operator does not have write permission fsck will 
default to a -n action. 

Fsck has more consistency checks than its predecessors check, dcheck, fcheck, and icheck combined. 

The following options are interpreted hy fsck. 

-y Assume a yes response to all questions asked hy fsck. 

-n Assume a no response to all questions asked by/sck; do not open the file system for writing. 

-sA Ignore the actual free list and (unconditionally) reconstruct a new one by rewriting the super-block 
of the file system. The file system should be unmounted while this is done; if this is not possible, 
care should be taken that the system is quiescent and that it is rebooted immediately afterwards. 
This precaution is necessary so that the old, bad, in-core copy of the superblock will not continue to 
be used, or written on the file system. 

The -sX option allows for creating an optimal free-list organization. The following forms of X are 
supported for the following devices: 

-s3 (RP03) 

-s4 (RP04, RP05, RP06) 

-sBlocks-per-cylinder:Blocks-to-skip (for anything else) 

If X is not given, the values used when the file system was created are used. If these values were 
not specified, then the value 400:7 is used. 

-SA Conditionally reconstruct the free list. This option is like -sA above except that the free list is rebuilt 
only if there were no discrepancies discovered in the file system. Using -S will force a no response 
to all questions asked hy fsck. This option is useful for forcing free list reorganization on uncon¬ 
taminated file systems. 

-t If fsck cannot obtain enough memory to keep its tables, it uses a scratch file. If the -t option is 
specified, the file named in the next argument is used as the scratch file, if needed. Without the -t 
hs.g,fsck will prompt the operator for the name of the scratch file. The file chosen should not be on 
the file system being checked, and if it is not a special file or did not already exist, it is removed 
when/sck completes. 

-q Quiet fsck. Do not print size-check messages in Phase 1. Unreferenced fifos will silently be 
removed, \ifsck requires it, counts in the superblock will be automatically fixed and the free list sal¬ 
vaged. 

-D Directories are checked for bad blocks. Useful after system crashes. 

-f Fast check. Check block and sizes (Phase 1) and check the free list (Phase 5). The free list will be 
reconstructed (Phase 6) if it is necessary. 
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If no file-systems are specified,/icA: will read a list of default file systems from the file /etc/checklist. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one inode or the free list. 

2. Blocks claimed by an inode or the free list outside the range of the file system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks. 

Directory size not 16-byte aligned. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 

Inode number out of range. 

8. SuperBlockchecks: 

More than 65536 inodes. 

More blocks for inodes than there are in the file system. 

9. Bad free block list format. 

10. Total free block and/or free inode count incorrect. 

Orphaned files and directories (allocated but unreferenced) are, with the operator’s concurrence, recon¬ 
nected by placing them in the lostH-found directory, if the files are nonempty. The user will be notified if 
the file or directory is empty or not. If it is empty, fsck will silently remove them. Fsck will force the 
reconnection of nonempty directories. The name assigned is the inode number. The only restriction is that 
the directory lostH-found must preexist in the root of the file system being checked and must have empty 
slots in which entries can be made. This is accomplished by making lostH-found, copying a number of files 
to the directory, and then removing them (before/ick is executed). 

Checking the raw device is almost always faster and should be used with everything but the root file sys¬ 
tem. 

Dfsck 

Dfsck allows two file system checks on two different drives simultaneously, options! and options2 are 
used to pass options to fsck for the two sets of file systems. A - is the separator between the file system 
groups. 

The dfsck program permits an operator to interact with two/icA:(lM) programs at once. To aid in this, dfsck 
will print the file system name for each message to the operator. When answering a question from dfsck, 
the operator must prefix the response with a 1 or a 2 (indicating that the answer refers to the first or second 
file system group). 

Do not use dfsck to check the root file system. 

FILES 

/etc/checklist contains default list of file systems to check. 

/etc/checkall optimizing dfsck shell file. 

SEE ALSO 

checkall(lM), clri(lM), ncheck(lM), checklist(4), fs(4), crash(8). 

Setting up the UNIX System in the UNIX System Administrator’s Guide. 

BUGS 

Inode numbers for . and .. in each directory should be checked for validity. 

DIAGNOSTICS 

The diagnostics produced hy fsck are intended to be self-explanatory. 


Page 2 



FSCV(IM) 


(DEC only) 


FSCV(IM) 


NAME 

fscv - convert files between PDP-11 and VAX-11/780 systems 

SYNOPSIS 

/etc/fscv -V ispecial [ ospecial ] 

/etc/fscv -p ispecial [ ospecial ] 

DESCRIPTION 

Fscv converts file systems between PDP-11 and VAX-11/780 formats. The super block, free list, and inodes 
are converted to the format of the output file. Fscv may be executed on PDP-11 and VAX processors. The 
mandatory flag specifies the format of the converted file system: 

-V Convert file system from PDP-11 to VAX format. 

-p Convert file system from VAX to PDP-11 format. 

Ispecial is the name of a special file containing a file system to be converted (e.g.; /dev/rrpl). The optional 
ospecial is the name of the special file to receive the results of the conversion. If ospecial is specified the 
entire contents of ispecial are copied to ospecial before the conversion is performed. If ospecial is not 
specified an in-place conversion of ispecial is performed. The following items should be noted before exe¬ 
cuting/icv: 

1. A file system consistency check (/scA:(lM)) should be performed on ispecial immediately prior to 
executing/icv. 

2. Neither ispecial nor the optional ospecial should contain a mounted file system during execution of 
fscv. Modification to either the input or the output file system while/icv is executing will probably 
corrupt the converted file system. 

3. A backup of ispecial (see volcopy{\M)) is highly recommended if an in-place conversion is to be 
performed. System crashes, I/O errors, etc., during execution of fscv may destroy the file system 
contained in ispecial. Also, if the optional ospecial is specified any data contained in that special 
file will be over written. 

4. If the optional ospecial is specified, this special file must be large enough to contain the entire con¬ 
tents of ispecial. See the appropriate special files in section 4. 

EXAMPLES 

Copy and convert a file system from PDP-11 to VAX format: 

/etc/fscv -V /dev/rrpO /dev/rrplO 
Perform an in-place conversion from VAX to PDP-11 format: 

/etc/fscv -p /dev/rrplO 

BUGS 

The boot block is not modified during conversion. The resulting file system will not be bootable. No data 
contained in the files of the file system are modified. 

SEE ALSO 

fsck(lM), volcopy(lM). 
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NAME 

fsdb - file system debugger 

SYNOPSIS 

/etc/fsdb special [ - ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a crash. It has conversions to translate block and 
i-numbers into their corresponding disk addresses. Also included are mnemonic offsets to access different 
parts of an i-node. These greatly simplify the process of correcting control block entries or descending the 
file system tree. 

Fsdb contains several error checking routines to verify i-node and block addresses. These can be disabled 
if necessary by invokingwith the optional - argument or by the use of the O symbol. {Fsdb reads the 
i-size and f-size entries from the superblock of the file system as the basis for these checks.) 

Numbers are considered decimal by default. Octal numbers must be prefixed with a zero. During any 
assignment operation, numbers are checked for a possible truncation error due to a size mismatch between 
source and destination. 

Fsdb reads a block at a time and will therefore work with raw as well as block I/O. A buffer management 
routine is used to retain commonly used blocks of data in order to reduce the number of read system calls. 
All assignment operations result in an immediate write-through of the corresponding block. 

The symbols recognized by fsdb are: 

# 


absolute address 

convert from i-number to i-node address 
convert to block address 
directory slot offset 
address arithmetic 
quit 

save, restore an address 
numerical assignment 
incremental assignment 
decremental assignment 
character string assignment 
error checking flip flop 
general print facilities 
file print facility 
byte mode 
word mode 
double word mode 
escape to shell 

The print facilities generate a formatted output in various styles. The current address is normalized to an 
appropriate boundary before printing begins. It advances with the printing and is left at the address of the 
last item printed. The output can be terminated at any time by typing the delete character. If a number fol¬ 
lows the p symbol, that many entries are printed. A check is made to detect block boundary overflows 
since logically sequential blocks are generally not physically sequential. If a count of zero is used, all 
entries to the end of the current block are printed. The print options available are: 
i print as i-nodes 

print as directories 
print as octal words 
print as decimal words 
print as characters 
print as octal bytes 
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The f symbol is used to print data blocks associated with the current i-node. If followed by a number, that 
block of the file is printed. (Blocks are numbered from zero.) The desired print option letter follows the 
block number, if present, or the f symbol. This print facility works for small as well as large files. It 
checks for special devices and that the block pointers used to find the data are not zero. 

Dots, tabs and spaces may be used as function delimiters but are not necessary. A line with just a new-line 
character will increment the current address by the size of the data type last printed. That is, the address is 
set to the next byte, word, double word, directory entry or i-node, allowing the user to step through a region 
of a file system. Information is printed in a format appropriate to the data type. Bytes, words and double 
words are displayed with the octal address followed by the value in octal and decimal. A .B or .D is 
appended to the address for byte and double word values, respectively. Directories are printed as a direc¬ 
tory slot offset followed by the decimal i-number and the character representation of the entry name. 
Inodes are printed with labeled fields describing each element. 

The following mnemonics are used for i-node examination and refer to the current working i-node; 
md mode 

In link count 

uid user ID number 

gid group ID number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj major device number 

min minor device number 

EXAMPLES 

386i prints i-number 386 in an i-node format. This now becomes the current working i- 

node. 

ln=4 changes the link count for the working i-node to 4. 

ln=H-1 increments the link count by 1. 

fc prints, in ASCII, block zero of the file associated with the working i-node. 

2i fd prints the first 32 directory entries for the root i-node of this file system. 

d5i fc changes the current i-node to that associated with the 5th directory entry (numbered 

from zero) found from the above command. The first logical block of the file is then 
printed in ASCII. 

512B.p0o prints the superblock of this file system in octal. 

2i.a0b.d7=3 changes the i-number for the seventh directory slot in the root directory to 3. This 

example also shows how several operations can be combined on one command line. 

d7.nm="name" changes the name field in the directory slot to the given string. Quotes are optional 
when used with nm if the first character is alphabetic. 

a2b.p0d prints the third block of the current inode as directory entries. 

SEE ALSO 

fsck(lM), dir(4), fs(4). 
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NAME 

fts - Field Test Set interface 

SYNOPSIS 

/etc/fts find util-id 
/etc/fts stat file 

/etc/fts set hex-num command args 

DESCRIPTION 

Fts provides an interface to the 3B20S Field Test Set (FTS). The FTS is a hardware device for tracing the 
execution of a process based on its utility ID. 

For the UNIX System, the utility ID of a process is a 24 bit quantity divided into two fields. By default; the 
low order 16 bits contain the i-number of the process file, and the high order 8 bits contain the minor device 
number of the filesystem on which the process file exists. 

After afork{2) system call, the child process’s utility ID is the same as the parent’s. After an exec(2) sys¬ 
tem call, if the process’s utility ID had previously been modified (see below), it remains unchanged, other¬ 
wise it is set to the default value. 

The following options are recognized hy fts: 

find util-id Prints on the standard output, the device name and path name of a file that has utility ID of 
util-id. Util-id is interpreted as a hexadecimal constant. 

sinifile Prints on the standard output, the utility ID of file. 

sethex-num command args 

Changes its own utility ID, and then overlays itself with command. The new utility ID is as fol¬ 
lows: the high order 8 bits have the value -1 (all bits set), and the low order 16 bits are set to 
hex-num. Hex-num is interpreted as a hexadecimal constant. 

SEE ALSO 

exec(2), fork(2), sys3b(2). 
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NAME 

fuser - identify processes using a file or file structure 
SYNOPSIS 

/etc/fuser [ -ku ] files [ - ] [ [ -ku ] files ] 

DESCRIPTION 

Fuser lists the process IDs of the processes using the files specified as arguments. For block special 
devices, all processes using any file on that device are listed. The process ID is followed by c, p or r if the 
process is using the file as its current directory, the parent of its current directory (only when in use by the 
system), or its root directory, respectively. If the -u option is specified, the login name, in parentheses, 
also follows the process ID. In addition, if the -k option is specified, the SIGKILL signal is sent to each 
process. Only the super-user can terminate another user’s process (see kill{2)). Options may be respecified 
between groups of files. The new set of options replaces the old set, with a lone dash canceling any options 
currently in force. 

The process IDs are printed as a single line on the standard output, separated by spaces and terminated with 
a single new line. All other output is written on standard error. 

EXAMPLES 

fuser -ku /dev/dskl ? 

will terminate all processes that are preventing disk drive one from being unmounted if typed by 
the super-user, listing the process ID and login name of each as it is killed. 

fuser -u /etc/passwd 

will list process IDs and login names of processes that have the password file open. 

fuser -ku /dev/dskl? -u /etc/passwd 

will do both of the above examples in a single command line. 

Note that the above device names for disks are generic to the 3B20S and may be different on other proces¬ 
sors. 

FILES 

/unix for namelist 

/dev/kmem for system image 
/dev/mem also for system image 

SEE ALSO 

mount(lM), ps(l), kill(2), signal(2). 
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NAME 

fwtmp, wtmpfix - manipulate connect accounting records 
SYNOPSIS 

/usr/lib/acct/fwtmp [-ic] 

/usr/lib/acct/wtmpfix [files] 

DESCRIPTION 

Ewtmp 

Fwtmp reads from the standard input and writes to the standard output, converting binary records of the 
type found in wtmp to formated ASCII records. The ASCII version is useful to enable editing, via ed{V), 
bad records or general purpose maintenance of the file. 

The argument -ic is used to denote that input is in ASCII form, and output is to be written in binary form. 
Wtmpfix 

Wtmpfix examines the standard input or named files in wtmp format, corrects the time/date stamps to make 
the entries consistent, and writes to the standard output. A - can be used in place of files to indicate the 
standard input. If time/date corrections are not performed, acctconl will fault when it encounters certain 
date change records. 

Each time the date is set, a pair of date change records are written to /etc/wtmp. The first record is the old 
date denoted by the string old time placed in the line field and the flag OLD TIME placed in the type held 
of the <utmp h> structure. The second record specifies the new date and is denoted by the string new time 
placed in the line held and the flag NEW TIME placed in the type held. Wtmpfix uses these records to syn¬ 
chronize all time stamps in the file. 

In addition to correcting time/date stamps, wtmpfix will check the validity of the name held to ensure that it 
consists soley of alphanumeric characters, a $ or spaces. If it encounters a name that is considered invalid, 
it will change the login name to INVALID and write a diagnostic to the standard error. In this way, wtmpfix 
reduces the chance that acctconl will fail when processing connect accounting records. 

EILES 

/etc/wtmp 
/usr/include/utmp h 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), runacct(lM), 
acct(2), acct(4), utmp(4). 
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NAME 

getty - set terminal type, modes, speed, and line discipline 

SYNOPSIS 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ linedisc ] ] ] 

/etc/getty -c file 

DESCRIPTION 

Getty is a program that is invoked by /n/f(lM). It is the second process in the series, {init-getty-login-shell) 
that ultimately connects a user with the UNIX System. Initially getty prints the login message held for the 
entry it is using from /etc/gettydefs. Getty reads the user’s login name and invokes the login{\) command 
with the user’s name as argument. While reading the name, getty attempts to adapt the system to the speed 
and type of terminal being used. 

Line is the name of a tty line in /dev to which getty is to attach itself. Getty uses this string as the name of a 
hie in the /dev directory to open for reading and writing. Unless getty is invoked with the -h hag, getty 
will force a hangup on the line by setting the speed to zero before setting the speed to the default or 
specihed speed. The -t hag plus timeout in seconds, specihes that getty should exit if the open on the line 
succeeds and no one types anything in the specihed number of seconds. The optional second argument, 
speed, is a label to a speed and tty dehnition in the hie /etc/gettydefs. This dehnition tells getty what speed 
to initially run at, what the login message should look like, what the inital tty settings are, and what speed 
to try next should the user indicate that the speed is inappropriate. (By typing a <break> character.) The 
default speed is 300 baud. The optional third argument, type, is a character string describing to getty what 
type of terminal is connected to the line in question. Getty understands the following types: 


none 

default 

vt61 

DEC vt61 

vtlOO 

DEC VtlOO 

hp45 

Hewlett-Packard HP45 

clOO 

Concept 100 


The default terminal is nonep; i.e., any crt or normal terminal unknown to the system. Also, for terminal 
type to have any meaning, the virtual terminal handlers must be compiled into the operating system. They 
are available, but not compiled in the default condition. The optional fourth argument, linedisc, is a charac¬ 
ter string describing which line discipline to use in communicating with the terminal. Again the hooks for 
line disciplines are available in the operating system but there is only one presently available, the default 
line discipline, LDISCO. 

When given no optional arguments, getty sets the speed of the interface to 300 baud, specifies that raw 
mode is to be used (awaken on every character), that echo is to be suppressed, either parity allowed, new- 
line characters will be converted to carriage return-line feed, and tab expansion performed on the standard 
output. It types the login message before reading the user’s name a character at a time. If a null character 
(or framing error) is received, it is assumed to be the result of the user pushing the “break” key. This will 
cause getty to attempt the next speed in the series. The series that getty tries is determined by what it hnds 
in /etc/gettydefs. 

The user’s name is terminated by a new-line or carriage-return character. The latter results in the system 
being set to treat carriage returns appropriately (see ioctl{2)). 

The user’s name is scanned to see if it contains any lower-case alphabetic characters; if not, and if the name 
is non-empty, the system is told to map any future upper-case characters into the corresponding lower-case 
characters. 

Finally, login is called with the user’s name as an argument. Additional arguments may be typed after the 
login name. These are passed to login, which will place them in the environment (see login{\)). 

A check option is provided. When getty is invoked with the -c option wAfile, it scans the hie as if it were 
scanning /etc/gettydefs and prints out the results to the standard output. If there are any unrecognized 
modes or improperly constructed entries, it reports these. If the entries are correct, it prints out the values 
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of the various flags. See ioctl(2) to interpret the values. Note that some values are added to the flags auto¬ 
matically. 

EILES 

/etc/gettydefs 
SEE ALSO 

ct(lC), init(lM), login(l), ioctl(2), gettydefs(4), inittab(4), tty(7). 
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NAME 

init, telinit - process control initialization 
SYNOPSIS 

/etc/init [ 0123456SsQq ] 

/etc/telinit [ 0123456sSQqabc ] 

DESCRIPTION 

Init 

Init is a general process spawner. Its primary role is to create processes from a script stored in the file 
/etc/inittab (see inittab(4)). This file usually has init spawn geffy’s on each line that a user may log in on. 
It also controls autonomous processes required by any particular system. 

Init considers the system to be in a run-level at any given time. A run-level can be viewed as a software 
configuration of the system where each configuration allows only a selected group of processes to exist. 
The processes spawned by init for each of these run-levels is defined in the inittab file. Init can be in one of 
eight run-levels, 0-6 and S or s. The run-level is changed by having a privileged user run /etc/init (which 
is linked to /etc/telinit). This user spawned init sends appropriate signals to the orginal init spawned by the 
operating system when the system was rebooted, telling it which run-level to change to. 

Init is invoked inside the UNIX System as the last step in the boot procedure. The first thing init does is to 
look for /etc/inittab and see if there is an entry of the type initdefault (see inittab (A)). If there is, init uses 
the run-level specified in that entry as the initial run-level to enter. If this entry is not in inittab or inittab is 
not found, init requests that the user enter a run-level from the virtual system console, /dev/syscon. If an S 
(s) is entered, init goes into the SINGLE USER level. This is the only run-level that doesn’t require the exis¬ 
tence of a properly formatted inittab file. If /etc/inittab doesn’t exist, then by default the only legal run- 
level that init can enter is the SINGLE USER level. In the SINGLE USER level the virtual console terminal 
/dev/syscon is opened for reading and writing and the command /bin/su is invoked immediately. To exit 
from the SINGLE USER run-level one of two options can be elected. First, if the shell is terminated (via an 
end-of-file), init will reprompt for a new run-level. Second, the init or telinit command can signal init and 
force it to change the run-level of the system. 

When attempting to boot the system, failure of init to prompt for a new run-level may be due to the fact that 
the device /dev/syscon is linked to a device other than the physical system teletype (/dev/systty). If this 
occurs, init can be forced to relink /dev/syscon by typing a delete on the system teletype which is co¬ 
located with the processor. 

When init prompts for the new run-level, the operator may only enter one of the digits 0 through 6 or the 
letters S or s. If S is entered init operates as previously described in SINGLE USER mode with the additional 
result that /dev/syscon is linked to the user’s terminal line, thus making it the virtual system console. A 
message is generated on the physical console, /dev/systty, saying where the virtual terminal has been relo¬ 
cated. 

When init comes up initially and whenever it switches out of SINGLE USER state to normal run states, it sets 
the ioctl(2) states of the virtual console, /dev/syscon, to those modes saved in the file /etc/ioctl.syscon. 
This file is written by init whenever SINGLE USER mode is entered. If this file doesn’t exist when init wants 
to read it, a warning is printed and default settings are assumed. 

If a 0 through 6 is entered init enters the corresponding run-level. Any other input will be rejected and the 
user will be re-prompted. If this is the first time init has entered a run-level other than SINGLE USER, init 
first scans inittab for special entries of the type boot and bootwait. These entries are performed, providing 
the run-level entered matches that of the entry before any normal processing of inittab takes place. In this 
way any special initialization of the operating system,such as mounting file systems, can take place before 
users are allowed onto the system. The inittab file is scanned to find all entries that are to be processed for 
that run-level. 

Run-level 2 is usually defined by the user to contain all of the terminal processes and daemons that are 
spawned in the multi-user environment. 
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In a multi-user environment, the inittab file is usually set up so that init will create a process for each termi¬ 
nal on the system. 

For terminal processes, ultimately the shell will terminate because of an end-of-file either typed explicitly 
or generated as the result of hanging up. When init receives a child death signal, telling it that a process it 
spawned has died, it records the fact and the reason it died in /etc/utmp and /etc/wtmp if it exists (see 
w/zo(l)). A history of the processes spawned is kept in /etc/wtmp if such a file exists. 

To spawn each process in the inittab file, init reads each entry and for each entry which should be 
respawned, it forks a child process. After it has spawned all of the processes specified by the inittab file, 
init waits for one of its descendant processes to die, a powerfail signal, or until init is signaled by init or 
telinit to change the system’s run-level. When one of the above three conditions occurs, init re-examines 
the inittab file. New entries can be added to the inittab file at any time; however, init still waits for one of 
the above three conditions to occur. To provide for an instantaneous response the init Q or init q command 
can wake init to re-examine the inittab file. 

If init receives a powerfail signal (SIGPWR) and is not in SINGLE USER mode, it scans inittab for special 
powerfail entries. These entries are invoked (if the run-levels permit) before any further processing takes 
place. In this way init can perform various cleanup and recording functions whenever the operating system 
experiences a power failure. It is important to note that the powerfail entries should not use devices that 
must first be initialized (e.g. dzb lines) after a power failure has occurred. 

When init is requested to change run-levels (via telinit), init sends the warning signal (SIGTERM) to all 
processes that are undefined in the target run-level. Init waits 20 seconds before forcibly terminating these 
processes via the kill signal (SIGKILL). 

Telinit 

Telinit, which is linked to /etc/init, is used to direct the actions of init. 
and signals init via the kill system call to perform the appropriate action 
directives to init. 

0-6 tells init to place the system in one of the run-levels 0-6. 

a,b,c tells init to process only those /etc/inittab file entries having the a, b or c run-level set. 
Q,q tells init to re-examine the /etc/inittab file. 

s,S tells init to enter the single user environment. When this level change is effected, the 

virtual system teletype, /dev/syscon, is changed to the terminal from which the com¬ 
mand was executed. 

Telinit can only be run by someone who is super-user or a member of group sys. 

FILES 

/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/dev/syscon 

/dev/systty 

SEE ALSO 

getty(lM), login(l), sh(l), who(l), kill(2), inittab(4), utmp(4). 

DIAGNOSTICS 

If init finds that it is continuously respawning an entry from /etc/inittab more than 10 times in 2 minutes, it 
will assume that there is an error in the command string, and generate an error message on the system con¬ 
sole, and refuse to respawn this entry until either 5 minutes has elapsed or it receives a signal from a user 
init (telinit). This prevents init from eating up system resources when someone makes a typographical 
error in the inittab file or a program is removed that is referenced in the inittab. 


. It takes a one character argument 
. The following arguments serve as 
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NAME 

install - install commands 


SYNOPSIS 

/etc/install [-c dira] [-f dirb] [-1] [-n dire] [-o] [-s] file [dirx ...] 

DESCRIPTION 

Install is a command most commonly used in “makefiles” (see make{\)) to install s.file (updated target 
file) in a specific place within a file system. Each file is installed by copying it into the appropriate direc¬ 
tory, thereby retaining the mode and owner of the original command. The program prints messages telling 
the user exactly what files it is replacing or creating and where they are going. 

If no options or directories {dirx .. .) are given, install will search a set of default directories (/bin, 
/usr/bin, /etc, /lib, and /usr/lib, in that order) for a file with the same name as file . When the first occur¬ 
rence is found, install issues a message saying that it is overwriting that file with^/e, and proceeds to do 
so. If the file is not found, the program states this and exits without further action. 

If one or more directories (dirx ...) are specified afterthose directories will be searched before the 
directories specified in the default list. 

The meanings of the options are: 


-c dira 


-f dirb 


-n dire 


-o 


-s 


SEE ALSO 

make(l), mk(8). 


Installs a new command (file) in the directory specified by dira, only if it is not 
found. If it is found, install issues a message saying that the file already exists, 
and exits without overwriting it. May be used alone or with the -s option. 

Forces to be installed in given directory, whether or not one already exists. If 
the file being installed does not already exist, the mode and owner of the new file 
will be set to 755 and bin, respectively. If the file already exists, the mode and 
owner will be that of the already existing file. May be used alone or with the -o or 
-s options. 

Ignores default directory list, searching only through the given directories (dirx 
...). May be used alone or with any other options other than -c and -f. 

If file is not found in any of the searched directories, it is put in the directory 
specified in dire. The mode and owner of the new file will be set to 755 and bin, 
respectively. May be used alone or with any other options other than -c and -f. 

\ffile is found, this option saves the “found” file by copying it to OLDfile in the 
directory in which it was found. This option is useful when installing a normally 
text busy file such as /bin/sh or /ete/getty, where the existing file cannot be 
removed. May be used alone or with any other options other than -c. 

Suppresses printing of messages other than error messages. May be used alone or 
with any other options. 
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NAME 

ipb - read the EAI Input Parameter Buffer 

SYNOPSIS 

/etc/ipb 

DESCRIPTION 

Ipb prints the settings of the various fields in the EAI Input Parameter Buffer. Information displayed 
includes the method used to boot the system, whether the backup root file system is being used, whether 
certain hardware error checks are enabled and whether minimal configuration has been specified. 

PILES 

/usr/include/sys/ipb.h 

SEE ALSO 

3B20ops(8). 
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NAME 

killall - kill all active processes 

SYNOPSIS 

/etc/killall [ signal ] 

DESCRIPTION 

Killall is is a procedure used by /etc/shutdown to kill all active processes not directly related to the shut 
down procedure. 

Killall is chiefly used to terminate all processes with open files so that the mounted file systems will be 
unbusied and can be unmounted. 

Killall sends signal (see kill(l)) to all remaining processes not belonging to the above group of exclusions. 
If no signal is specified, a default of 9 is used. 

PILES 

/etc/shutdown 
SEE ALSO 

fuser(lM), kill(l), ps(l), shutdown(lM), signal(2). 
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NAME 

link, unlink - exercise link and unlink system calls 

SYNOPSIS 

/etc/link file 1 file2 
/etc/unlink file 

DESCRIPTION 

Link and unlink perform their respective system calls on their arguments, abandoning all error checking. 
These commands may only be executed by the super-user, who (it is hoped) knows what he or she is doing. 

SEE ALSO 

rm(l), link(2), unlink(2). 
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NAME 

Ipadmin - configure the LP spooling system 
SYNOPSIS 

/usr/lib/lpadmin -p printer [ options ] 

/usr/lib/lpadmin -x dest 
/usr/lib/lpadmin -d[dest] 

DESCRIPTION 

Lpadmin configures LP spooling systems to describe printers, classes and devices. It is used to add and 
remove destinations, change membership in classes, change devices for printers, change printer interface 
programs and to change the system default destination. Lpadmin may not be used when the LP scheduler, 
lpsched{\M), is running, except where noted below. 

Exactly one of the -p, -d or -x options must be present for every legal invocation of Ipadmin. 

-A{dest\ makes dest, an existing destination, the new system default destination. If dest is not supplied, 
then there is no system default destination. This option may be used when lpsched{\M) is 
running. No other options are allowed with -d. 

-xdest removes destination dest from the LP system. If dest is a printer and is the only member of a 
class, then the class will be deleted, too. No other options are allowed with -x. 

-^printer names a printer to which all of the options below refer. If printer does not exist then it will be 
created. 

The following options are only useful with -p and may appear in any order. For ease of discussion, the 
printer will be refered to as P below. 

-cclass inserts printer P into the specihed class. Class will be created if it does not already exist. 

-eprinter copies an existing printer’s interface program to be the new interface program for P. 

-h indicates that the device associated with P is hardwired. This option is assumed when creating 

a new printer unless the -1 option is supplied. 

-linterface establishes a new interface program for P. Interface is the path name of the new program. 

-1 indicates that the device associated with P is a login terminal. The LP scheduler, Ipsched, dis¬ 

ables all login terminals automatically each time it is started. Before re-enabling P, its current 
device should be established using Ipadmin. 

-mmodel selects a model interface program for P. Model is one of the model interface names supplied 
with the LP software (see Models below). 

-rclass removes printer P from the specihed class. If P is the last member of the class, then the class 
will be removed. 

-ydevice associates a new device with printer P. Device is the pathname of a hie that is writable by the 

LP administrator. Ip. Note that there is nothing to stop an administrator from associating the 
same device with more than one printer. If only the -p and -v options are supplied, then 
Ipadmin may be used while the scheduler is running. 

Restrictions. 

When creating a new printer, the -v option and one of the -e, -i or -m options must be supplied. Only one 
of the -e, -i or -m options may be supplied. The -h and -1 keyletters are mutually exclusive. Printer and 
class names may be no longer than 14 characters and must consist entirely of the characters A-Z, a-z, 0-9 
and _ (underscore). 

Models. 

Model printer interface programs are supplied with the LP software. They are shell procedures which inter¬ 
face between Ipsched and devices. All models reside in the directory /usr/spool/lp/model and may be used 
as is with Ipadmin -m. Alternatively, LP administrators may modify copies of models and then use 
Ipadmin -i to associate them with printers. The following list describes the models and lists the options 
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which they may be given on the Ip command line using the -o keyletter: 

dumb interface for a line printer without special functions and protocol. Form feeds are assumed. This is 
a good model to copy and modify for printers which do not have models. 

1640 Diablo 1640 terminal running at 1200 baud, using XON/XOFF protocol. Options: 

-12 12-pitch (10-pitch is the default) 

-f don’t use the 450(1) hlter. The output has been pre-processed by either 450(1) or the 
nroff450 driving table. 

hp Hewlett Packard 2631A line printer at 2400 baud. Options: 

-c compressed print 

-e expanded print 

prx Printronix P300 printer using XON/XOFF protocol at 1200 baud. 

EXAMPLES 

1. Assuming there is an existing Hewlett Packard 2631A line printer named hp2, it will use the hp model 
interface after the command: 

/usr/lib/lpadmin -php2 -mhp 

2. To obtain compressed print on hp2, use the command: 

Ip -dhp2 -o-c hies 

3. A Diablo 1640 printer called stl can be added to the LP conhguration with the command: 

/usr/lib/lpadmin -pstl -v/dev/tty20 -ml640 

4. An nrcy(f document may be printed on stl in any of the following ways: 

nroff -T450 hies I Ip -dstl -of 
nroff -T450-12 hies I Ip -dstl -of 
nroff -T37 hies I col I Ip -dstl 

5. The following command prints the password hie on stl in 12-pitch: 

Ip -dstl -ol2 /etc/passwd 

NOTE: the -12 option to the 1640 model should never be used in conjunction with nrojf. 

PILES 

/usr/spool/lp/* 

SEE ALSO 

450(1), accept(lM), enable(l), lp(l), Ipsched(lM), Ipstat(l). 
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NAME 

Ipsched, Ipshut, Ipmove - startystop the LP request scheduler and move requests 

SYNOPSIS 

/usr/lib/lpsched 

/usr/lib/lpshut 

/usr/lib/lpmove requests dest 
/usr/lib/lpmove destl dest2 

DESCRIPTION 

Lpsched schedules requests taken by lp{\) for printing on line printers. 

Lpshut shuts down the line printer scheduler. All printers that are printing at the time Ipshut is invoked will 
stop printing. Requests that were printing at the time a printer was shut down will be reprinted in their 
entirety after Ipsched is started again. All LP commands perform their functions even when Ipsched is not 
running. 

Lpmove moves requests that were queued by lp{\) between LP destinations. This command may be used 
only when Ipsched is not running. 

The first form of the command moves the named requests to the LP destination, dest. Requests are request 
ids as returned by Ip. The second form moves all requests for destination destl to destination destl. As a 
side effect. Ip will reject requests for destl. 

Note that Ipmove never checks the acceptance status (see accept{\M)) for the new destination when moving 
requests. 

PILES 

/usr/spool/lp/* 

SEE ALSO 

accept(lM), enable(l), lp(l), Ipadmin(lM), Ipstat(l). 
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NAME 

mkboot - convert a.out file to boot image 

SYNOPSIS 

/etc/mkboot a.out-file boot-file 
DESCRIPTION 

Mkboot creates boot-file as a main-memory image of the a.out-file. Mkboot creates the boot-file with the 
text first, null byte padding from the end of the text to the start of the data, the data, null byte data for the 
bss, and null byte padding to bring the boot-file size up to a multiple of 512. 

DIAGNOSTICS 

Mkboot prints the starting and ending addresses for text, data, and bss on the standard error output. 
Self-explanatory complaints about bad arguments and bad a.out format. 
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NAME 

mkfs - construct a file system 
SYNOPSIS 

/etc/mkfs special blocks [: inodes] [gap blocks/cyl] 

/etc/mkfs special proto [gap blocks/cyl] 

DESCRIPTION 

Mkfs constructs a file system by writing on the special file according to the directions found in the remain¬ 
der of the command line. If the second argument is given as a string of digits, mkfs builds a file system 
with a single empty directory on it. The size of the file system is the value of blocks interpreted as a deci¬ 
mal number. This is the number of physical disk blocks the file system will occupy. The boot program is 
left uninitialized. If the optional number of inodes is not given, the default is the number of logical blocks 
divided by 4. 

If the second argument is a file name that can be opened, mkfs assumes it to be a prototype file proto, and 
will take its directions from that file. The prototype file contains tokens separated by spaces or new-lines. 
The first token is the name of a file to be copied onto block zero as the bootstrap program (see 3B20boot{%) 
or unixboot{%y). The second token is a number specifying the size of the created file system in physical 
disk blocks. Typically it will be the number of blocks on the device, perhaps diminished by space for 
swapping. The next token is the number of inodes in the file system. The maximum number of inodes 
configurable is 65500. The next set of tokens comprise the specification for the root file. File specifications 
consist of tokens giving the mode, the user ID, the group ID, and the initial contents of the file. The syntax 
of the contents field depends on the mode. 

The mode token for a file is a 6 character string. The first character specifies the type of the file. (The char¬ 
acters -bed specify regular, block special, character special and directory files respectively.) The second 
character of the type is either u or - to specify set-user-id mode or not. The third is g or - for the set- 
group-id mode. The rest of the mode is a three digit octal number giving the owner, group, and other read, 
write, execute permissions (see chmod{l)). 

Two decimal number tokens come after the mode; they specify the user and group ID’s of the owner of the 
file. 

If the file is a regular file, the next token is a path name whence the contents and size are copied. If the file 
is a block or character special file, two decimal number tokens follow which give the major and minor 
device numbers. If the file is a directory, mkfs makes the entries . and „ and then reads a list of names and 
(recursively) file specifications for the entries in the directory. The scan is terminated with the token $. 

A sample prototype specification follows: 

/standidiskboot 
4872 110 
d—777 3 1 


d—777 3 1 


sh — 

-755 3 1 /bin/sh 

ken d— 

-755 6 1 

$ 


bO b- 

-644 3 1 0 0 

O 

O 

O 

1 

-644 3 1 0 0 


$ 

$ 

In both command syntaxes, the rotational gap and the number of blocks/cyl can be specified. The follow¬ 
ing values are recommended; 
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Device 

Gap Size 

Blks/Cyl 

RLOl/02 

7 

40 

RP03 

5 

200 

RP04/05/06 

7 

418 

RP07 

7 

400 

RM03 

7 

160 

RM05 

7 

608 

RM80 

9 

434 

3B20S MHD 

7 

608 

default 

7 

400 


The default will be used if the supplied gap and blocks/cyl are considered illegal values or if a short argu¬ 
ment count occurs. 

SEE ALSO 

dir(4), fs(4), unixboot(8), 3B20boot(8). 


BUGS 

If a prototype is used, it is not possible to initialize a file larger than 64K bytes, nor is there a way to specify 
links. 
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NAME 

mknod - build special file 
SYNOPSIS 

/etc/mknod name c I b major minor 
/etc/mknod name p 

DESCRIPTION 

Mknod makes a directory entry and corresponding i-node for a special file. The first argument is the name 
of the entry. In the first case, the second is b if the special file is block-type (disks, tape) or c if it is 
character-type (other devices). The last two arguments are numbers specifying the major device type and 
the minor device (e.g. unit, drive, or line number), which may be either decimal or octal. 

The assignment of major device numbers is specihc to each system. They have to be dug out of the system 
source file conf.c. 

Mknod can also be used to create fifo’s (a.k.a named pipes) (second case in SYNOPSIS above). 

SEE ALSO 

mknod(2). 
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NAME 

mount, umount - mount and dismount file system 
SYNOPSIS 

/etc/mount [ special directory [ -r ] ] 

/etc/umount special 
DESCRIPTION 

Mount announces to the system that a removable hie system is present on the device special. The 
directory must exist already; it becomes the name of the root of the newly mounted hie system. 

These commands maintain a table of mounted devices. If invoked with no arguments, mount prints the 
table. 

The optional last argument indicates that the hie is to be mounted read-only. Physically write-protected and 
magnetic tape hie systems must be mounted in this way or errors will occur when access times are updated, 
whether or not any explicit write is attempted. 

Umount announces to the system that the removable hie system previously mounted on device special is to 
be removed. 


PILES 

/etc/mnttab mount table 
SEE ALSO 

setmnt(lM), mount(2), mnttab(4). 

DIAGNOSTICS 

Mount issues a warning if the hie system to be mounted is currently mounted under another name. 

Umount complains if the special hie is not mounted or if it is busy. The hie system is busy if it contains an 
open hie or some user’s working directory. 

BUGS 

Some degree of validation is done on the hie system, however it is generally unwise to mount garbage hie 
systems. 
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NAME 

msi - memory system diagnostic interface 

SYNOPSIS 

/etc/msi 

/etc/msi rmv cap 
/etc/msi rst c a p 
/etc/msi clr c a p 
/etc/msi enb 
/etc/msi dis 
/etc/msi find cap 
/etc/msi kill cap 

DESCRIPTION 

Msi provides the facility for controlling the memory system of the processor. The granularity for memory 
management is a 2K page. A physical memory board (or array) can contain from 64 to 512 pages, depend¬ 
ing on board type. There can be 16 arrays on a memory controller and 2 controllers on a system. Hence, to 
completely specify a memory page requires the controller number, array number and page number indicated 
by c, a, and p respectively, in the argument list. These numbers are supplied by the operating system in the 
event of a memory system error. 

Msi will become interactive if invoked without arguments. Valid arguments are: 

Rmv will queue the addressed page for removal. The page cannot be removed immediately if it is 
currently in use, but must be delayed until the process claiming it moves or terminates. Certain 
memory system errors will automatically queue a page for removal. 

Rst will return a previously removed page back to the system for re-use. 

Clr will clear the addressed page, typically removing any parity errors in the page at the expense 
of lost data. 

Enb will enable the hardware refresh and correctable parity error detection for the entire memory 
system. 

Dis will disable the hardware error detection. This must be done before a new array is installed to 
prevent a flood of refresh parity errors before the new pages are cleared. 

Find will search for the first process claiming the addressed page. 

Kill will terminate all processes using the addressed page. 

SEE ALSO 

3B20ops(8). 
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NAME 

mvdir - move a directory 

SYNOPSIS 

/etc/mvdir dirname name 
DESCRIPTION 

Mvdir renames directories within a file system. Dirname must be a directory; name must not exist. Nei¬ 
ther name may be a sub-set of the other (/x/y cannot be moved to /x/y/z, nor vice versa). 

Only super-user can use mvdir. 

SEE ALSO 

mkdir(l). 
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NAME 

ncheck - generate names from i-numbers 

SYNOPSIS 

/etc/ncheck [ -i numbers ] [ -a ] [ -s ] [ file-system ] 

DESCRIPTION 

Ncheck with no argument generates a path name vs. i-number list of all files on a set of default hie systems. 
Names of directory hies are followed by /.. The -i option reduces the report to only those hies whose i- 
numbers follow. The -a option allows printing of the names . and which are ordinarily suppressed. The 
-s option reduces the report to special hies and hies with set-user-ID mode; it is intended to discover con¬ 
cealed violations of security policy. 

A hie system may be specihed. 

The report is in no useful order, and probably should be sorted. 

SEE ALSO 

fsck(lM), sort(l). 

DIAGNOSTICS 

When the hie system structure is improper, ?? denotes the “parent” of a parentless hie and a path name 
beginning with ... denotes a loop. 
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NAME 

newboot - load VTOC, prom patch, or Iboot 
SYNOPSIS 

/etc/newboot boot-special [ -v vtoc ] [ -u prompat ] [ -1 Iboot ] 

DESCRIPTION 

Newboot replaces the entries specified by its options on the given boot-special section of a disk. Newboot 
verifies that each given file will fit in the specified entry, and calls dd{\)to move it in. 

Lboot is a file containing the boot program that is loaded by the 3B20S firmware and executed to boot the 
UNIX System. 

Prompat is a file containing patches to the system microcode that are read in by the 3B20S firmware when 
the machine is booted. 

Vtoc is a file containing a volume table of contents used by the 3B20S firmware to find the prom patch and 
Iboot locations on disk and is used by Iboot to find the root and backup root file systems. 

SEE ALSO 

dd(l), mkboot(lM), 3B20boot(8). 

DIAGNOSTICS 

FILE too large (BLKS blocks max.) FILE is too big for the specified entry, 
unknown option X Option X not recognized, 

can’t open file EILE FILE not found. 

WARNINGS 

Installing a bad vtoc, prompat, or Iboot may make the affected disk pack unbootable. Be sure you have a 
good backup disk before newboot is run. 
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NAME 

nscloop - perform the NSC local network loopback functions 
SYNOPSIS 

/usr/nsc/nscloop [netname...] [-1] [-s] [-c] [-u units] [-d names] [-f file] [-m login] 

DESCRIPTION 

Nscloop uses the message loopback feature of the NSC adapter hardware to gather network statistics and to 
operationally query the availability of remote adapters. Nscloop generates and prints a brief report on the 
standard output. The first argument to nscloop may be one or more network names (see nscmon(IM) for a 
complete description of a network). If no network is given, all the networks specified in the network file, 
/usr/nsc/nets will be accessed. If more than one network is specified, the -f, -d, -u options are disabled. 
For each network specified, the -1, -s, and/or -c functions are performed on all known adapters, as deter¬ 
mined by the network topological file, /etc/nsc. Nscloop recognizes the following options: 

-1 Loop a message and associated data block off each specified adapter. Compare each byte sent 

with each byte returned and report comparison errors. This is the default mode. 

-s Gather and report the trunk statistics for the specified adapters. 

-c Gather, report, and clear the trunk statistics for the specified adapters. This function is reserved 

to the super-user. 

-f file Use file as the network topological file for the specified network. This file contains the symbolic 
names of each machine on the network. A report is generated for each unique adapter that 
configured hosts are connected to. File format is assumed to be as follows: 

machine_name: anything: anything:device 

-d names Perform the indicated function to only those adapters on the specified network where the host 
name is connected. 

-u units Perform the indicated functions to only those adapters on the specified network whose unit num¬ 
ber is unit. 

-m login Send mail to login if any error is detected. 

By default, option -1 is enabled. If more that one of -1, -s, or -c are specified, each function will be per¬ 
formed on the indicated adapters. If no adapters are explicitly selected for reporting, nscloop will query all 
adapters for the specified network found in the network topological file, /etc/nsc. 

EILES 

/etc/nsc the NSC network topological file 

SEE ALSO 

nscmon(lM). 

DIAGNOSTICS 

All error messages are designed to be self-explanatory. 
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NAME 

nscmon - operationally control the NSC local network 

SYNOPSIS 

/etc/nscmon options 

DESCRIPTION 

Nscmon provides the operational interface to control the NSC local network. Nscmon starts and stops all 
network transfers; nscmon enables and inhibits transfers to individual nodes. All operations are in the eyes 
of the local node only. 

The nusend(lC) software allows the support of more than one adapter on a host, where each adapter defines 
a separate network. The network file /usr/nsc/nets contains all the networks known to the local node. 
Most operations require the specification of one or more networks. If more than one netname is given, the 
operation is performed on each network in turn. Every option that requires a netname may optionally take 
the special case all. In that case, the option will perform its operation for all the networks known, as 
specified in the network file /usr/nsc/nets. The following options are recognized; 

-start netname 

Start up the nusend{\C) software on the local node for the specified network. This command 
initializes the NSC listener process for each network, marks all the currently configured nodes 
online, and enables the routing of file transfers across the NSC network. This command will 
not clear a hung adapter or NSC driver. The converse of this option is -stop. 

-stop netname 

Terminate the nusend(lC) software on the local node for the specified network. Any files cur¬ 
rently queued as well as all subsequent jobs will be routed across the RJE link (if it exists). 
This command inhibits any incoming or outgoing file transfers. This command will not clear a 
hung adapter or hung NSC driver. 

-cancel netname 

Cancel the current active adapter operation (within the driver) for the driver associated with the 
specified network. The operation is marked as though it had failed. An error will be returned 
to the user process and suspended processes will continue normally. This command is espe¬ 
cially useful for clearing hung processes within the driver. 

-halt netname 

Disable (via software) all operations to the adapter for the specified network. The driver will 
process opens normally, but all functions to the adapter will be inhibited. This command does 
not clear a hung driver or hung processes, but inhibits all operations to the adapter. The con¬ 
verse of this command is -restart. 

-restart netname 

Enable (via software) all adapter operations for the adapter associated with the specified net¬ 
work. This command restarts any suspended processes within the driver. This function is the 
converse of -halt. 

-t netname Turn off the NSC adapter to adapter protocol process tracing for the adapter associated with the 
specified network. The binary trace files may be found in /usr/nsc/log/nsclog.*, where the * is 
the process ID of the read/send process. 

-Ht netname Turn on the NSC adapter protocol process tracing for the adapter associated with the specified 
network. 

-e netname Turn off the NSC adapter to adapter protocol error logging for the adapter associated with the 
specified network. The binary error files may be found in /usr/nsc/log/nscerr.*, where the * is 
the process ID of the read/send process. 

H-e netname Turn on the NSC adapter protocol error logging for the adapter associated with the specified 
network. 
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-ps Print certain information about active nusend{\C) processes. The format of the listing is: 

PID TIME CMD 

Nscsend and nscread processes are listed under their parents. The format for orphan processes 
is: 

PID PPID TIME CMD 

The cumulative execution time (TIME) is not displayed on the UNIX System/370 implementa¬ 
tion. 

-on netname names 

Mark all nodes in the name list for the specified network online and notify the node to forward 
all queued files to the local machine. If name is the special case all all nodes for the specified 
network are marked up, as configured in the network topological file, /etc/nsc. Any files cur¬ 
rently queued for the named node(s) and all subsequent submitted transfers to the named 
node(s) will be routed across the NSC network. This function is automatically performed if the 
-start option is used. 

-off netname names 

Mark all the nodes in the name list for the specified network offline. If name is the special case 
all all the nodes for the specified network are marked offline, as configure in the network topo¬ 
logical file, /etc/nsc. Any files currently queued for the named node(s) and all subsequent jobs 
submitted to the specified node(s) will be routed across the RJE link (if it exists). 

-p netname names 

Same as -on option. 

-clear Clear the process table of (kill off) all nusend(lC) processes that did not die normally. 

-loop Perform the NSC local loopback function. Same as nscloop -1. 

-stat Query the operational status of the NSC network. Same as nscstat -1. 

All options may be freely interdispersed; the operations will be performed in the order given on the com¬ 
mand line. 

FILES 

/etc/nsc 
/usr/nsc/nets 
/usr/nsc/log/nsclog.* 

/usr/nsc/log/nscerr.* 

/usr/nsc/online/* 

/usr/nsc/cons/* 

/usr/nsc/rvchan 
/usr/nsc/nsctorje 
/usr/nsc/nsccmd 

/usr/nsc/nsclisten 
/usr/nsc/nscd 
/usr/nsc/nscrecv 
SEE ALSO 

nscloop(lM), nscstat(lC), nsctorje(lC). 

DIAGNOSTICS 

All error messages are designed to be self explanatory. 


the network topological file 

the networks known to the local node and the associated devices 
binary trace log 
binary NSC error log 

the NSC network is enabled for this network 

remote nodes currently considered online locally 

nodes currently configured on the network 

program that routes jobs on inactive nodes across the RJE line 

program that sends a message to a remote machine telling it to send any queued jobs 

to the local machine 

the NSC network listen daemon 

the NSC network send daemon 

the NSC network receive daemon 
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NAME 

pcldaemon - PCL link monitor 

SYNOPSIS 

/usr/lib/pcldaemon 

DESCRIPTION 

Pcldaemon monitors the pcl{l) control channel, servicing requests as they arrive. Requests are transmitted 
via nef(lC). 

PILES 

/dev/pcl/.^[0-7] PCL channel interfaces for system ?. 

/dev/pcl/ctrl PCL control channel. 

/usr/adm/pcllog 

activity log. 

SEE ALSO 

net(lC), pcl(7). 

DIAGNOSTICS 

cannot open pci control channel 

Another pcldaemon is running. 

WARNINGS 

Running pcldaemon may present security hazards. A super-user may nef(lC) to any system on the PCL bus 
that is running pcldaemon and execute any command on that system. 
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NAME 

prm - send a Processor Recovery Message 

SYNOPSIS 

/etc/prm message 

DESCRIPTION 

Prm sends a Processor Recovery Message (PRM) to the Emergency Action Interface (EAI). 

Message is converted to a 16 nibble sequence and must therefore contain only the digits 1 through 9 and 
the characters a through f. After the command, message will appear in the PRM field of the EAI display. 

SEE ALSO 

3B20ops(8). 

BUGS 

Because of the design of the EAI it is possible to miss a PRM if insufficient time has passed since the last 
message. 
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NAME 

prfld, prfstat, prfdc, prfsnap, prfpr - operating system profiler 

SYNOPSIS 

/etc/prfld [ namelist ] 

/etc/prfstat [ on I off ] 

/etc/prfdc file [ period [ off_hour ] ] 

/etc/prfsnap file 

/etc/prfpr file [ cutoff [ namelist ] ] 

DESCRIPTION 

Prfld, prfstat, prfdc, prfsnap, and prjpr form a system of programs to facilitate an activity study of the 
UNIX operating system. 

Prfld is used to initialize the recording mechanism in the system. It generates a table containing the starting 
address of each system subroutine as extracted from namelist. 

Prfstat is used to enable or disable the sampling mechanism. Profiler overhead is less than 1% as calcu¬ 
lated for 500 text addresses. Prfstat will also reveal the number of text addresses being measured. 

Prfdc and prfsnap perform the data collection function of the profiler by copying the current value of all the 
text address counters to a file where the data can be analyzed. Prfdc will store the counters into file every 
period minutes and will turn off at offjiour (valid values for offjiour are 0-24). Prfsnap collects data at 
the time of invocation only, appending the counter values to file. 

Prfpr formats the data collected by prfdc or prfsnap. Each text address is converted to the nearest text 
symbol (as found in namelist) and is printed if the percent activity for that range is greater than cutoff. 

FILES 

/dev/prf interface to profile data and text addresses 
/unix default for namelist file 

SEE ALSO 

prf(7). 
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NAME 

pwck, grpck - password/group file checkers 

SYNOPSIS 

/etc/pwck [file] 

/etc/grpck [file] 

DESCRIPTION 

Pwck scans the password file and notes any inconsistencies. The checks include validation of the number 
of fields, login name, user ID, group ID, and whether the login directory and optional program name exist. 
The criteria for determining a valid login name is derived from Setting up the UNIX System in the UNIX 
System Administrator’s Guide. The default password file is /etc/passwd. 

Grpck verifies all entries in the group file. This verification includes a check of the number of fields, group 
name, group ID, and whether all login names appear in the password file. The default group file is 

/etc/group. 

PILES 

/etc/group 

/etc/passwd 

SEE ALSO 

group(4), passwd(4). 

Setting up the UNIX System in UNIX System Administrator’s Guide. 

DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

reboot - reboot the system 

SYNOPSIS 

/etc/reboot 

DESCRIPTION 

Reboot generates a Maintenance Reset Function (MRF), causing the processor to enter its system bootstrap 
code thereby rebooting the system. It can be used to reboot the processor remotely, but this is practical 
only if a terminal line is enabled in /etc/inittab for state 1 so that the file systems can be checked and state 
2 entered. 

Since the boot sequence will prompt for a pathname at the system console if PROMPT UNIX is set in the 
EAI, make sure that this is not the case by using ipb{\M) beforehand. 

Reboot will enter the boot sequence immediately, without flushing the internal system buffers. It must be 
used with extreme caution. 

SEE ALSO 

ipb(lM), 3B20ops(8). 
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NAME 

rmv - remove unit from service before on-line diagnostics 

SYNOPSIS 

/dgn/bin/rmv name unit 
DESCRIPTION 

Rmv removes the device specified by name and unit from service. For example, the following command 
line removes DEC 1 (Disk File Controller 1) from service: 

rmv dfc 1 

SEE ALSO 

dgn(lM), rst(lM). 

3B DMERT Output Messages, OM-4C000-01. 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 
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NAME 

rst - restore unit to service after on-line diagnostics 

SYNOPSIS 

/dgn/bin/rst name unit [ options ] 

DESCRIPTION 

Rst restores the device identified by name and unit into service according to the options specified. A device 
can be restored to service conditionally or unconditionally. By default, rst restores a device into service 
conditionally, unless the the option ucl is specified. A conditional restore implies that diagnostics will first 
be performed, and the final results must be ATP (All Tests Passed) before the device will be restored to ser¬ 
vice. Otherwise the device is left out of service. If the device is restored unconditionally (i.e., ucl option is 
specified), then no diagnostics are performed. 

The following options are recognized, each as a separate argument: 

raw Print the diagnostic results of every phase and all failures. By default, only the final results and 

first five failures of each failing phase will be printed. 

ucl Unconditionally restore the device specified by name and unit into service. Note this option 

implies that no diagnostics will be performed. 

tip Executes the Trouble Location Procedure at the conclusion of the diagnostic. This procedure 

analyzes all diagnostic failures and generates a weighted list of faulty circuit packs. This 
option must not be used in conjunction with ucl. 

^le=filename 

Routes all output messages into a file named filename instead of the user’s terminal. Filename 
is opened for appending and is relative to the directory /dgn/dgnc unless a full pathname is 
specified. 

cont This option is only effective when name and unit is an Input-Output Processor (lOP). By 

default, rst will restore an lOP and its associated peripheral controllers (PCs) into service. Use 
of this option restores only the lOP and not its PCs. Note that restoring a Disk File Controller 
(DFC) never implies restoring its Moving Head Disks (MHDs). 
hu =name unit 

This option allows a helper unit identified by name and unit to be specified. For example, 
when diagnosing the magnetic tape controller (i.e., UN32), a diagnostic test tape with a write 
ring must be mounted on the specified helper unit. The following example shows how one 
might invoke diagnostics using the helper unit option: 
dgn un32 0 ph=5 hu=mt 2 

EXAMPLES 

The following two examples show how one might invoke this command for either an unconditional or con¬ 
ditional restore, respectively. 

Example 1: 

rst dfc 1 ucl 

would restore the device dfc 1 into service unconditionally. The option ucl is the only 
valid option for an unconditional restore request. 

Example 2: 

rst dfc 1 raw tip file=filename 

would restore the device dfc 1 to service if all diagnostics results were ATP. The remain¬ 
ing options are applied as described above. 

SEE ALSO 

dgn(lM), rmv(lM). 

3B DMERT Output Messages, OM-4C000-01. 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 
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NAME 

ranacct - run daily accounting 
SYNOPSIS 

/usr/lib/acct/runacct [mmdd [state]] 

DESCRIPTION 

Runacct is the main daily accounting shell procedure. It is normally initiated via cron{\M). Runacct pro¬ 
cesses connect, fee, disk, and process accounting files. It also prepares summary files for prdaily or billing 
purposes. 

Runacct takes care not to damage active accounting files or summary files in the event of errors. It records 
its progress by writing descriptive diagnostic messages into active. When an error is detected, a message is 
written to /dev/console, mail (see mail{\)) is sent to root and adm, and runacct terminates. Runacct uses a 
series of lock files to protect against re-invocation. The files lock and lockl are used to prevent simultane¬ 
ous invocation, and lastdate is used to prevent more than one invocation per day. 

Runacct breaks its processing into separate, restartable states using statefile to remember the last state 
completed. It accomplishes this by writing the state name into statefile. Runacct then looks in statefile to 
see what it has done and to determine what to process next. States are executed in the following order: 

SETUP Move active accounting files into working files. 

WTMPEIX Verify integrity of wtmp file, correcting date changes if necessary. 

CONNECTI Produce connect session records in ctmp h format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct h format. 

MERGE Merge the connect and process accounting records. 

EEES Convert output of chargefee into tacct.h format and merge with connect and pro¬ 

cess accounting records. 

DISK Merge disk accounting records with connect, process, and fee accounting records. 

MERGETACCT 

Merge the daily total accounting records in daytacct with the summary total 
accounting records in /usr/adm/acct/suin/tacct. 

CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting programs can be included here. 

CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for diagnostics, then fix up any corrupted data 
files such as pacct or wtmp. The lock files and lastdate file must be removed before runacct can be res¬ 
tarted. The argument mmdd is necessary if runacct is being restarted, and specifies the month and day for 
which runacct will rerun the accounting. Entry point for processing is based on the contents of statefile; to 
override this, include the desired state on the command line to designate where processing should begin. 

EXAMPLES 

To start runacct. 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 

To restart runacct. 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 

To restart runacct at a specific state. 

nohup runacct 0601 MERGE 2» /usr/adm/acct/nite/fd21og & 

EILES 

/etc/wtmp 
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/usr/adm/pacct* 

/usr/src/cmd/acct/tacct h 
/usr/src/cmd/acct/ctmp.h 
/usr/adm/ acct/nite/active 
/usr/adm/acct/nite/daytacct 
/usr/adm/ acct/nite/lock 
/usr/adm/acct/nite/lockl 
/usr/adm/ acct/nite/lastdate 
/usr/adm/ acct/nite/statefile 
/usr/adm/ acct/nite/ptacct* .mmdd 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), cron(lM), 
fwtmp(lM), acct(2), acct(4), utmp(4). 

UNIX Accounting System in the UNIX System Administrator’s Guide. 

DIAGNOSTICS 

The accounting system will start complaining with ***reCOMPILE pnpsplit WITH NEW HOLIDAYS*** 
after the last holiday of the year. See The UNIX System Accounting for more on how to correct this condi¬ 
tion. Other diagnostics are placed in various error and log files. 

BUGS 

Normally it is not a good idea to restart runacct in the SETUP state. Run SETUP manually and restart via: 
runacct mmdd WTMPEIX 

If runacct failed in the PROCESS state, remove the last placet file because it will not be complete. 
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NAME 

sal, sa2, sadc - system activity report package 

SYNOPSIS 

/usr/lib/sa/sadc [t n] [ ofile ] 

/usr/lib/sa/sal [t n] 

/usr/lib/sa/sa2 [-ubdycwaqvm] [-s time ] [-e time ] [-i sec ] 

DESCRIPTION 

System activity data can be accessed at the special request of a user (see sar(l)) and automatically on a rou¬ 
tine basis as described here. The operating system contains a number of counters that are incremented as 
various system actions occur. These include CPU utilization counters, buffer usage counters, disk and tape 
I/O activity counters, TTY device activity counters, switching and system-call counters, file-access counters, 
queue activity counters, and counters for inter-process communications. 

Sadc and shell procedures sal and sa2 are used to sample, save and process this data. 

Sadc, the data collector, samples system data n times every t seconds and writes in binary format to ofile or 
to standard output. If t and n are omitted, a special record is written. This facility is used at system boot 
time to mark the time at which the counters restart from zero. The /etc/rc entry: 

su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sa'date 
writes the special record to the daily data file to mark the system restart. 

The shell script sal, a variant of sadc, is used to collect and store data in binary file /usr/adm/sa/safiffif 
where dd is the current day. The arguments t and n cause records to be written n times at an interval of t 
seconds, or once if omitted. The entries in crontab (see cron (IM)): 

0 * * * 0,6 su sys -c "/usr/lib/sa/sal" 

0 8-17 * * 1-5 su sys -c "/usr/lib/sa/sal 1200 3" 

0 18-7 * * 1-5 su sys -c "/usr/lib/sa/sal" 

will produce records every 20 minutes during working hours and hourly otherwise. 

The shell script sa2, a variant of sar(l), writes a daily report in file /usr/adm/sa/sart/cf. The options are 
explained in sar(l). The crontab entry: 

5 18 * * 1-5 su adm -c "/usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 3600 -A" 

will report important activities hourly during the working day. 
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The structure of the binary daily data file is: 
struct sa { 

struct sysinfo si; /* see /usr/include/sys/sysinfo h */ 
int szinode; /* current entries of inode table */ 
int szfile; /* current entries of file table */ 

int sztext; /* current entries of text table */ 

int szproc; /* current entries of proc table */ 

int mszinode; /* size of inode table */ 

int mszfile; /* size of file table */ 

int msztext; /* size of text table */ 

int mszproc; /* size of proc table */ 
long inodeovf; /* cumul. overflows of inode table */ 
long inodeovf; /* cumul. overflows of file table */ 

long textovf; /* cumul. overflows of text table */ 

long procovf; /* cumul. overflows of proc table */ 
time_t ts; /* time stamp, seconds */ 

long devio[NDEVS][4]; /* device info for up to NDEVS units */ 
#deflne lO OPS 0 /* cumul. I/O requests */ 

#deflne lO BCNT 1 /* cumul. blocks transferred */ 

#deflne lO ACT 2 /* cumul. drive busy time in ticks */ 

#deflne lO RESP 3 /* cumul. I/O resp time in ticks */ 

}; 

ftt.es 

/usr/adm/sa/sat/t/ daily data file 

/usr/adm/sa/sart/t/ daily report file 

/tmp/sa.adrfl address file 

SEE ALSO 

sag(lG), sar(l), timex(l). 
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NAME 

setmnt - establish mount table 

SYNOPSIS 

/etc/setmnt 

DESCRIPTION 

Setmnt creates the /etc/mnttab table (see mnttab(4)), which is needed for both the mount{\M) and amount 
commands. Setmnt reads standard input and creates a mnttab entry for each line. Input lines have the for¬ 
mat: 

filesys node 

where is the name of the file system’s special file (e.g., “rp??”) and node is the root name of that 

file system. Thus^Zesyi and node become the first two strings in the mnttab (4) entry. 

PILES 

/etc/mnttab 

SEE ALSO 

mnttab(4). 

BUGS 

Evil things will happen filesys or node are longer than 10 characters. 

Setmnt silently enforces an upper limit on the maximum number of mnttab entries. 
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NAME 

setmrf - override system MRF action 

SYNOPSIS 

/etc/setmrf [ d I D I h I H I r ] 

DESCRIPTION 

Setmrf overrides the default action taken by the system in the event of a Maintenance Reset Function 
(MRF). A MRF can be caused by a hardware fault in the processor or as a result of a panic call in the oper¬ 
ating system. The default action is to reboot the processor. 

The h flag will cause the processor to enter an idle loop, resetting the internal sanity timer. The H flag will 
execute a halt instruction, causing all processor activity to stop. However, if the sanity timer is not inhib¬ 
ited at the EAI, the processor will reboot when the timer expires. 

The d flag sets the MRF action to its default value of dump to disk followed by reboot. The D flag causes 
the processor to idle after the dump is taken. 

The r flag causes the processor to reboot immediately, without taking a dump. 

All other values are not implemented and are treated as in the default case. 

SEE ALSO 

3B20ops(8). 
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NAME 

shutdown - terminate all processing 

SYNOPSIS 

/etc/shutdown 

DESCRIPTION 

Shutdown is part of the UNIX System operation procedures. Its primary function is to terminate all cur¬ 
rently running processes in an orderly and cautious manner. The procedure is designed to interact with the 
operator (i.e., the person who invoked shutdown). Shutdown may instruct the operator to perform some 
specihc tasks, or to supply certain responses before execution can resume. Shutdown goes through the fol¬ 
lowing steps: 

All users logged on the system are notihed to log off the system by a broadcasted message. The opera¬ 
tor may display his/her own message at this time. Otherwise, the standard hie save message is dis¬ 
played. 

If the operator wishes to run the hle-save procedure, shutdown unmounts all hie systems. 

All hie systems’ super blocks are updated before the system is to be stopped (see sync{\)). This must 
be done before re-booting the system, to insure hie system integrity. The most common error diagnos¬ 
tic that will occur is device busy. This diagnostic happens when a particular hie system could not be 
unmounted. 

SEE AUSO 

mount(lM), sync(l). 
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NAME 

ssr, setssr, clrssr - print or modify the System Status Register 

SYNOPSIS 

/etc/ssr 

/etc/setssr [bit... ] 

/etc/drssr [bit... ] 

DESCRIPTION 

The System Status Register (SSR) serves as both a display for certain processor information as well as a 
mechanism for controlling various processor actions. Although implemented with negative logic in the 
hardware, these commands function in the normal logic sense. The bit argument is a decimal integer speci¬ 
fying the bit position in the SSR. 

Ssr prints the current value of the SSR. 

Setssr asserts the specified bit positions in the SSR. 

Clrssr clears the specified bit positions in the SSR. 

Extreme caution must be exercised when using these commands as the System Status Register can alter 
processor behavior. In particular, certain bits will isolate the I/O system from the processor, causing the 
system to crash. 

Setssr and clrssr are most commonly used with bit 13 as an argument in order to enable or disable the 
cache bypass. 

PILES 

/usr/include/sys/ssr h 

SEE ALSO 

3B20ops(8). 
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NAME 

St - synchronous terminal control 

SYNOPSIS 

/etc/stload 

/etc/stcntrl control action 
/etc/stprint line device 

DESCRIPTION 

The stload command file is used to load the synchronous terminal prototype script, /lib/stscr, into the des¬ 
ignated VPM hardware, and start execution of the script. As supplied, stload uses VPM hardware unit 0 and 
/dev/stO; it will need local modification to use a different hardware unit or to start more than one syn¬ 
chronous communications line. 

The stcntrl command is used to activate and deactivate synchronous communications lines. The line that 
will be acted on is specified by control, (e.g. /dev/stO). The action argument may be either on, to activate 
the line, or off, to deactivate the line. The activation of a started line or the deactivation of a stopped line 
will result in an error. Note that stload activates the lines associated with the scripts that it loads. 

The /etc/rc file should contain the following multi-user entry: 

/etc/stload 


while each active synchronous line should be deactivated in /etc/shutdown by a line similar to the follow¬ 
ing: 

/etc/stcntrl /dev/stO off 


The stprint command associates a /dev/sp* file with a printer on synchronous communication line line with 
the ASCII device address character device. The stprint command prints the associated file name on its stan¬ 
dard output. 


PILES 

/lib/stscr 

/dev/un53.? 

/dev/kmc? 

/dev/st? 

/dev/tty* 

/dev/sp* 


synchronous terminal prototype script 
TN82/UN53 peripheral controller pair (3B20S only) 
KMCll-B microprocessor (DEC only) 
synchronous communications line control channels 
synchronous terminal user channels 
synchronous printer user channels 


SEE ALSO 

kmc(7), st(7), trace(7), un53(7), vpm(7). 
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NAME 

sta - find status of pending on-line diagnostic requests 

SYNOPSIS 

/dgn/bin/sta 

DESCRIPTION 

The diagnostic command sta reports the status of all currently pending diagnostic requests within the Main¬ 
tenance Input Request Administrator (MIRA). The contents of both the waiting and active diagnostic 
requests are printed along with their respective slot numbers. 

SEE ALSO 

dgn(lM), rmv(lM), rst(lM). 

3B DMERT Output Messages, OM-4C000-01. 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 
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NAME 

stgetty - wait on synchronous login line for use 
SYNOPSIS 

/etc/stgetty name type delay 
DESCRIPTION 

Stgetty is normally invoked by init{lM) as the first step in allowing users to login to the system. Lines in 
/etc/inittab tell init to invoke stgetty with the proper arguments. 

Name should be the name of a terminal in /dev (e.g., tty93); type should be a single character chosen from 
which is used to start up a line, or !, which tells stgetty to update /etc/utmp and exit; delay is relevant for 
dial-up ports only. It specifies the time in seconds that should elapse before the port is disconnected if the 
user does not respond to the login: request. 

Stlogin(l) is called with delay as an argument. 

SEE ALSO 

stlogin(l), init(lM), inittab(4), utmp(4), stermio(7). 
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NAME 

sysdef - system definition 

SYNOPSIS 

/etc/sysdef [ opsys [ master ] ] 

DESCRIPTION 

Sysdef analyzes the named operating system file and extracts configuration information. This includes all 
hardware devices as well as system devices and all tunable parameters. 

The output of sysdef cw usually be used directly by config{\M) to regenerate the appropriate conhguration 
files. 

FILES 

/unix default operating system hie 

/etc/master default table for hardware specihcations 

SEE ALSO 

conhg(lM), master(4). 

BUGS 

For devices that have interrupt vectors 
config. Because information regarding 
might not be accurate. 


but are not interrupt-driven, the output of sysdef cannot be used for 
config aliases is not preserved by the system, device names returned 
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NAME 

uuclean - uucp spool directory clean-up 
SYNOPSIS 

/usr/lib/uucp/uuclean [ options ] 

DESCRIPTION 

Uuclean will scan the spool directory for files with the specihed prehx and delete all those which are older 

than the specihed number of hours. 

The following options are available. 

-ddirectory Clean directory instead of the spool directory. 

-ppre Scan for hies with pre as the hie prehx. Up to 10 -p arguments may be specihed. A -p with¬ 
out any pre following will cause all hies older than the specihed time to be deleted. 

-ntime Files whose age is more than time hours will be deleted if the prehx test is satished. (default 
time is 72 hours) 

-vifile The default action for uuclean is to remove hies which are older than a specihed time (see -n 
option). The -w option is used to hnd those hies older than time hours, however, the hies are 
not deleted. If the argument is present the warning is placed in file, otherwise, the warn¬ 
ings will go to the standard output. 

ssys Only hies destined for system sys are examined. Up to 10 -s arguments may be specihed. 

-mfile The -m option sends mail to the owner of the hie when it is deleted. If a file is specihed then 

an entry is placed in file. 

This program is typically started by cron(IM). 

PILES 

/usr/lib/uucp directory with commands used by uuclean internally 

/usr/spool/uucp spool directory 

SEE ALSO 

cron(lM), uucp(lC), uux(lC). 
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NAME 

uusub - monitor uucp network 
SYNOPSIS 

/usr/lib/uucp/uusub [ options ] 

DESCRIPTION 

Uusub defines a uucp subnetwork and monitors the connection and traffic among the members of the sub¬ 
network. The following options are available: 

Add sys to the subnetwork. 

-diji Delete sys from the subnetwork. 

-1 Report the statistics on connections. 

-r Report the statistics on traffic amount. 

-f Flush the connection statistics. 

-ahr Gather the traffic statistics over the past hr hours. 

-csys Exercise the connection to the system sys. If sys is specified as all, then exercise the connection 
to all the systems in the subnetwork. 

The meanings of the connections report are: 

sys #call #ok time #dev #login #nack #other 

where sys is the remote system name, #call is the number of times the local system tries to call sys since 
the last hush was done, #ok is the number of successful connections, time is the latest successful connect 
time, #dev is the number of unsuccessful connections because of no available device (e.g. ACU), Mogin is 
the number of unsuccessful connections because of login failure, #nack is the number of unsuccessful con¬ 
nections because of no response (e.g. line busy, system down), and #other is the number of unsuccessful 
connections because of other reasons. 

The meanings of the traffic statistics are: 

sfile sbyte rfile rbyte 

where sfile is the number of files sent and sbyte is the number of bytes sent over the period of time indicated 
in the latest uusub command with the -uhr option. Similarly, rfile and rbyte are the numbers of files and 
bytes received. 

The command: 

uusub -c all -u 24 

is typically started by cron{\M) once a day. 

PILES 

/usr/spool/uucp/SYSLOG system log file 

/usr/lib/uucp/L_sub connection statistics 

/usr/lib/uucp/R_sub traffic statistics 

SEE ALSO 

uucp(lC), uustat(lC). 
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NAME 

vcf - VAX-11/780 configuration verification program 

DESCRIPTION 

This program scans hardware registers and software configuration tables in order to verify device availabil¬ 
ity and addressing. 

With the system halted, any of the console commands may be executed as described in 780ops{%) under 
Console Operation. The following is an example of execution of vc/as seen on the console, starting with a 
halted system: 

»>H<cr> 

HALTED AT nnnnnnnn 

»>B<cr> 

CPU HALTED 

INIT SEQ DONE 

HALT INST EXECUTED 

HALTED AT nnnnnnnn 

LOAD DONE, nnnnnnnn BYTES LOADED 


The $$ prompt indicates that the stand-alone shell {sash) is ready to accept commands. To execute the 
configuration verification program, type: 

$$ stand/vcf [unixji.out] 

Default for the unixji.out file is /unix. 

Vc/will scan the VAX machine registers looking for Memory, MASSBUS Adapters (MBAs), and UNIBUS 
Adapters (UBAs). For memory and MASSBUS devices, hardware status information is reported. Informa¬ 
tion on UNIBUS devices is obtained from configuration information in the UNIX System executable, and an 
attempt is made to verify device address and interrupt vectors. 

EILES 

/unix (or other UNIX System executable) 

/stand/vcf 

SEE ALSO 

780ops(8). 
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NAME 

vlx - VAX-11/780 LSI console floppy interface 

SYNOPSIS 

vlx key [ flies ] 

DESCRIPTION 

Vlx is used to maintain the console floppy. The floppy is in DEC RT-11 format. Hence, s. file name is 
restricted to a 1- to 6-character alphanumeric name optionally followed by a . character separator and a 1- to 
3-character alphanumeric extension. Upper and lower cases are mapped together. Only the last component 
of a path name is used. 

Key is one character from the set drtx, optionally concatenated with one or both of vf. The meanings of the 
key characters are: 

d Delete the named files from the floppy, 
r Replace the named files on the floppy. 

t Print a table of contents of the floppy. If no names are given, all files are tabled. If names are given, 
only those files are tabled. 

X Extract the named files from the floppy. If no names are given, all files are extracted. 

V Verbose. When used with t, it gives a long listing of all information about the files. When used with 
X, it precedes each file with a name. 

f Use the next name as the floppy file name, instead of the default /dev/conflp. 

EILES 

/dev/conflp console floppy 

SEE ALSO 

780ops(8). 

BUGS 

Dependent on knowledge and correctness of DEC software. 


Page 1 



VOLCOPY(IM) 


VOLCOPY(IM) 


NAME 

volcopy, labelit - copy file systems with label checking 
SYNOPSIS 

/etc/volcopy [options] fsname speciall volnamel special2 volname2 
/etc/labelit special [ fsname volume [ -n ] ] 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a blocksize matched to the device. Options are: 

-a invoke a verification sequence requiring a positive operator response instead of the stan¬ 
dard 10 second delay before the copy is made, 

-s (default) invoke the DEL if wrong verification sequence. 

Other options are used only with tapes: 

-bpidensity bits-per-inch (i.e., 800/1600/6250, or for 3B20S systems with Kennedy tape drives, 

1600k), 

-feetsize size of reel in feet (i.e., 1200/2400), 

-reelnum beginning reel number for a restarted copy, 

-buf use double buffered I/O. 

The program requests length and density information if it is not given on the command line or is not 
recorded on an input tape label. If the file system is too large to fit on one reel, volcopy will prompt for 
additional reels. Labels of all reels are checked. Tapes may be mounted alternately on two or more drives. 

Hht fsname argument represents the mounted name (e.g.: root, ul, etc.) of the filsystem being copied. 

The special should be the physical disk section or tape (e.g.: /dev/rdskl5, /dev/rmtO, etc.). 

The volname is the physical volume name (e.g.: pk3, t0122, etc.) and should match the external label 
sticker. Such label names are limited to six or fewer characters. Volname may be - to use the existing vol¬ 
ume name. 

Speciall and volnamel are the device and volume from which the copy of the file system is being 
extracted. Speciall and volnamel are the target device and volume. 

Fsname and volname are recorded in the last 12 characters of the superblock (char fsname[6], vol- 
name[6];). 

Labelit can be used to provide initial labels for unmounted disk or tape file systems. With the optional 
arguments omitted, labelit prints current label values. The -n option provides for initial labeling of new 
tapes only (this destroys previous contents). 

EILES 

/etc/log/filesave.log a record of file systems/volumes copied 

SEE ALSO 

fs(4). 
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BUGS 

Only device names beginning /dev/rmt (on DEC systems) or /dev/rtp (on 3B20S systems) are treated as 
tapes. Tape record sizes are determined both by density and by drive type. On DEC systems, records are 
5,120 bytes long at 800 and 1600 bits-per-inch, and 25,600 bytes long at 6250 bits-per-inch. On 3B20S 
systems, records are 2,048 bytes long on the Kennedy (see un32{7)) tape drive (1600k option) and 5,120 
bytes long for all other tape drives. 
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NAME 

vpmc - compiler for the virtual protocol machine 
SYNOPSIS 

vpmc [-mrcx] [-s sfile] [-1 Ifile] [-1 ifile] [-o ofile] file 
DESCRIPTION 

Vpmc is the compiler for a language that is used to describe communications link protocols. The output of 
vpmc is a load module for the virtual protocol machine (VPM), which is a software construct for imple¬ 
menting communications link protocols (e.g., BISYNC) on the DEC KMCll-B microprocessor. VPM is 
implemented by an interpreter in the KMC which cooperates with a driver in the UNIX System host com¬ 
puter to transfer data over a communications link in accordance with a specified link protocol. The UNIX 
System user processes transfer data to or from a remote terminal or computer system through VPM using 
normal UNIX System open, read, write, and close operations. The VPM program in the KMC provides 
error control and flow control using the conventions specified in the protocol. 

The language accepted by vpmc is essentially a subset of C; the implementation of vpmc uses the RATFOR 
preprocessor (rai/br(l)) as a front end; this leads to a few minor differences, mostly syntactic. 

There are two versions of the interpreter. The appropriate version for a particular application is selected by 
means of the -i option. The BISYNC version (-1 bisync) supports half-duplex, character-oriented protocols 
such as the various forms of BISYNC. The HDLC version (-i hdlc) supports full-duplex, bit-oriented proto¬ 
cols such as HDLC. There is a separate HDLC interpreter for the KMSll eight-line multiplexor; this version 
is selected by -i hdlc/kms. The communications primitives used with the BISYNC version are character- 
oriented and blocking; the primitives used with the HDLC versions are frame-oriented and non-blocking. 

Options 

The meanings of the command-line options are: 

-m Use m4{\) instead of cpp as the macro preprocessor. 

-r Produce RATFOR output on the standard output and suppress the remaining compiler phases. 

-c Compile only (suppress the assembly and linking phases). 

-X Retain the intermediate files used for communication between passes. 

-s sfile Save the generated VPM assembly language on file sfile. 

-1 Ifile Produce a VPM assembly-language listing on file Ifile. 

-i ifile Use the interpreter version specified by ifile (default bisync). 

-o ofile Write the executable object file on file ofile (default a.out). 

These options may be given in any order. 

Programs 

Input to vpmc consists of a (possibly null) sequence of array declarations, followed by one or more function 
definitions. The first defined function is invoked (on command from the driver) to 

begin program execution. 

Eunctions 

A function definition has the following form: 

function name ( ) 
statementJ,ist 
end 

Function arguments (formal parameters) are not allowed. The effect of a function call with arguments can 
be obtained by invoking the function via a macro that first assigns the value of each argument to a global 
variable reserved for that purpose. See EXAMPLES below. 

A statementJist is a (possibly null) sequence of labeled statements. A labeled_statement is a statement 
preceded by a (possibly null) sequence of labels. A label is either a name followed by a colon (:) or a deci¬ 
mal integer optionally followed by a colon. 
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The statements that make up a statement list must be separated by semicolons (;). (A semicolon at the end 
of a line can usually be omitted; refer to the description of RATFOR for details.) Null statements are 
allowed. 

Statement Syntax 

The following types of statements are allowed: 

expression 

lvalue =expression 

lvalue +=expression 

lvalue-=expression 

lvalue I =expression 

lvalue&=expression 

lvalue^=expression 

lvalue<S=expression 

lvalue:s>=expression 

if(expression)statement 

if(expression)statement else statement 

while(expression)statement 

foT(statement; expression', statement)statement 

repeat statement 

repeat statement until expression 

break 

next 

switch(express/on) { case_list } 
ietmn(expression ) 
return 
goto name 

goto decimal_constant 
{statement_list } 

repeat is equivalent to the do keyword in C; next is equivalent to continue. 

A casejist is a sequence of statement lists, each of which is preceded by a label of the form: 
case constant'. 

The label for the last statementJist in a casejist may be of the form: 
default: 

Unlike C, RATFOR supplies an automatic break preceding each new case label. 

Expression Syntax 

A primary_expression (abbreviated primary) is an lvalue or a constant. An lvalue is one of the following: 
name 

name [constant] 

A unary_expression (abbreviated unary) is one of the following: 

primary 
name () 
systemjoall 
++lvalue 
—lvalue 
{expression) 

\ unary 
~ unary 
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The following types of expressions are allowed: 
unary 

unary+primary 
unary-primary 
unary \ primary 
unary &primary 
unary &~prima ry 
unary^primary 
unary ^.primary 
unary^primary 
unary ==primary 
unary \=primary 
unary >primary 
unary <primary 
unary >=primary 
unary <=primary 

Note that the right operand of a binary operator can only be a constant, a name, or a name with a constant 
subscript. 

System Calls 

A VPM program interacts with a communications device and a driver in the host computer by means of sys¬ 
tem calls (primitives). 

The following primitives are available only in the BISYNC version of the interpreter: 
atoeiprimary) 

Translate ASCII to EBCDIC. The returned value is the EBCDIC character that corresponds to the 
ASCII character represented by the value of the primary expression. The translation tables reflect 
the prejudices of a particular installation. 

crcl6(primary) 

The value of the primary expression is combined with the cyclic redundancy check-sum at the 
location passed by a previous crcloc system call. The CRC-16 polynomial +x^ + 1) is 

used for the check-sum calculation. 

crcloc(name) 

The two-byte array starting at the location specified by name is cleared. The address of the array 
is recorded as the location to be updated by subsequent crcl6 system calls. 

etoaiprimary) 

Translate EBCDIC to ASCII. The returned value is the ASCII character that corresponds to the 
EBCDIC character represented by the value of the primary expression. The translation tables 
reflect the prejudices of a particular installation. 

gei{lvalue) 

Get a byte from the current transmit buffer. The next available byte, if any, is copied into the 
location specified by lvalue. The returned value is zero if a byte was obtained, otherwise it is 
non-zero. 

getrbuf(name) 

Get (open) a receive buffer. The returned value is zero if a buffer is available, otherwise it is non¬ 
zero. If a buffer is obtained, the buffer parameters are copied into the array specified by name. 
The array should be large enough to hold at least three bytes. The meaning of the buffer parame¬ 
ters is driver-dependent. If a receive buffer has previously been opened via a getrbuf call but has 
not yet been closed via a call to rtnrbuf, that buffer is reinitialized and remains the current buffer. 

getxbuf(name) 

Get (open) a transmit buffer. The returned value is zero if a buffer is available, otherwise it is 
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non-zero. If a buffer is obtained, the buffer parameters are copied into the array specified by 
name. The array should be large enough to hold at least three bytes. The meaning of the buffer 
parameters is driver-dependent. If a transmit buffer has previously been opened via a getxbuf call 
but has not yet been closed via a call to rtnxbuf, that buffer is reinitialized and remains the current 
buffer. 

putCpnmary) 

Put a byte into the current receive buffer. The value of the primary expression is inserted into the 
next available position, if any, in the current receive buffer. The returned value is zero if a byte 
was transferred, otherwise it is non-zero. 

rc\{lvalue) 

Receive a character. The process delays until a character is available in the input silo. The charac¬ 
ter is then moved to the location specified by lvalue and the process is reactivated. 

r&ova{constant) 

Skip to the beginning of a new receive frame. The receiver hardware is cleared and the value of 
constant is stored as the receive sync character. This call is used to synchronize the local receiver 
and remote transmitter when the process is ready to accept a new receive frame. 

rtnrbuf(nflme) 

Return a receive buffer. The original values of the buffer parameters for the current receive buffer 
are replaced with values from the array specihed by name. The current receive buffer is then 
released to the driver. 

rtnxbuf(name) 

Return a transmit buffer. The original values of the buffer parameters for the current transmit 
buffer are replaced with values from the array specihed by name. The current transmit buffer is 
then released to the driver. 

xeom{constant) 

Transmit end-of-message. The value of the constant is transmitted, then the transmitter is shut 
down. 

xmtiprimary) 

Transmit a character. The value of the primary expression is transmitted over the communications 
line. If the output silo is full, the process waits until there is room in the silo. 

xsom{constant) 

Transmit start-of-message. The transmitter is cleared, then the value of constant is transmitted six 
times. This call is used to synchronize the local transmitter and the remote receiver at the begin¬ 
ning of a frame. 

The following primitives are available only with the HDLC version of the interpreter: 

abtxfrm() 

The current transmission, if any, is aborted, if possible, by sending a frame-abort sequence (seven 
one bits, followed immediately by a terminating flag). This operation is not feasible with some 
hardware interfaces, in which case this primitive is a no-operation. 

getxfrmip rimary) 

Get a transmit buffer. If the transmit-buffer queue is not empty, the buffer at the head of the queue 
is removed from the queue and attached to the sequence number specified by the value of the pri¬ 
mary expression If the sequence number is greater than seven or the sequence number already has 
a buffer attached, the process is terminated in error. The returned value is zero if a buffer was 
obtained, otherwise non-zero. 

norbufO 

Test for the availability of an empty receive buffer. The returned value is true (non-zero) if the 
queue of empty receive buffers is currently empty; otherwise the returned value is false (zero). 
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rcvfrm(name) 

Get a completed receive frame. If the queue of completed receive frames is non-empty, the frame 
at the head of the queue is removed and becomes the current receive frame. If a frame is obtained, 
the first five bytes of the frame are copied into the array specified by name. The returned value is 
true (non-zero) if a frame was obtained; otherwise, it is false (zero). The rightmost four bits of the 
returned value indicate the frame length as follows: if the value of the rightmost four bits is equal 
to fifteen, the frame length is greater than or equal to 15; otherwise the frame length is equal to the 
value of the rightmost four bits. The frame length includes the two CRC bytes at the end of the 
frame and any control information at the beginning of the frame. Bytes following the first two 
bytes of the frame, but not including the two CRC bytes, are copied into a receive buffer, if one is 
available at the time the frame is received. Bit 020 of the returned value is zero if a receive buffer 
was available, otherwise non-zero. The values of the leftmost three bits of the returned value are 
currently unspecified. If a frame was obtained, the first five bytes of the frame are copied into the 
array specified by name. Frames with errors are discarded; a count is kept for each type of error. 
Frames may be discarded for any of the following reasons: (1) CRC error, (2) frame too short (less 
than four bytes), (3) frame too long (buffer size exceeded), or (4) no receive buffer available. If a 
frame with a buffer attached was previously obtained with rcvfrm, but the buffer has not been 
released to the driver with rtnrfrm, that buffer is returned to the queue of empty receive buffers. 
At most one receive frame with no buffer attached is retained by the interpreter; if a new frame 
arrives before the frame with no buffer attached has been obtained with rcvfrm, the new frame is 
discarded. 

rtnrfrmO 

Return a receive buffer. The current receive buffer (the one obtained by the most recent rcvfrm 
primitive) is returned to the driver. If there is no current receive buffer, the process is terminated 
in error. 

rsxmtq() 

Reset the transmit-buffer queue. The sequence number assignment is removed from all transmit 
buffers. If a transmission is currently in progress, the transmission is aborted, if possible. 

rtnxfrm (primary) 

Return a transmit buffer. The transmit buffer currently attached to the sequence number specified 
by the value of the primary expression is returned to the driver and the sequence number assign¬ 
ment is removed from that buffer. If the specified sequence number does not have a buffer 
attached, the process is terminated in error. Transmit buffers must be returned in the same 
sequence in which they were obtained, otherwise the process is terminated in error. 

setctl(name ,primary) 

Specify transmit-control information. The number of bytes specified by the primary expression 
are copied from the array specified by name and saved for use with subsequent xmtfrm or xmtctl 
primitives. If the transmitter is currently busy, the process is terminated in error. 

xmtbusyC) 

Test for transmitter busy. If a frame is currently being transmitted, the returned value is true 
(non-zero); otherwise the returned value is false (zero). 

xmtctl() 

Transmit a control frame. If a transmission is not already in progress, a new transmission is initi¬ 
ated. The transmitted frame will contain the control information specified by the most recent 
setctl primitive, followed by a two-byte CRC. The CRC-CCITT polynomial + \ ) is 

used for the CRC calculation. The returned value is zero if a new transmission was initiated, other¬ 
wise non-zero. 

xmtfrm (primary) 

Transmit an information frame. If a transmission is not already in progress, a new transmission is 
initiated. The transmitted frame will contain the control information specified by the most recent 
setctl primitive, followed by the contents of the buffer which is currently attached to the sequence 
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number specified by the value of the primary expression followed by a two-byte CRC. The CRC- 
CCITT polynomial (x*® -l-x^ -I-1) is used for the CRC calculation. The returned value is zero 

if a new transmission was initiated, otherwise non-zero. If the sequence number is greater than 
seven or the sequence number does not have a buffer attached, the process is terminated in error. 

The following primitives are available with all versions of the interpreter: 

dsrwait() 

Wait for modem-ready and then set modem-ready mode. The process delays until the modem- 
ready signal from the modem interface is asserted. If the modem-ready signal subsequently drops, 
the process is terminated. If dsrwait is never invoked, the modem-ready signal is ignored. 

exitiprimary) 

Terminate execution. The process is halted and the value of the primary expression is passed to 
the driver. 

getcmd(name) 

Get a command from the driver. If a command has been received from the driver since the last 
call to getcmd, four bytes of command information are copied into the array specified by name 
and a value of true (non-zero) is returned. If no command is available, the returned value is false 
(zero). 

getoptO 

Get the script options. Script options are passed from the protocol driver to the VPM interpreter by 
means of the common synchronous interface (CSI). These bits are recorded by CSI; the most 
recent value is passed to the VPM interpreter each time the protocol script is started. This value is 
saved by the interpreter and can be retrieved as many times as desired using the getopt primitive. 
The low-order bit of this value is used by the BX.25 level 2 script (cslapb r) to determine whether 
to use address A or address B. 

pause) ) Return control to the dispatcher. This primitive informs the dispatcher that the virtual process may 
be suspended until the next occurrence of an event that might affect the state of the protocol for 
this line. Examples of such events are: (1) completion of an output transfer, (2) completion of an 
input transfer, (3) timer expiration, and (4) a buffer-in command from the driver. In a multi-line 
implementation, the pause primitive allows the process for a given line to give up control to allow 
the processor to service another line. In a single-line implementation this primitive has no effect. 

snap(nflme) 

Create a snap event record. Four bytes from the array specified by name are passed to the driver, 
which prefixes a time stamp and sequence number and creates a trace event record containing the 
data. If minor device 1 of the trace driver is currently open, the record is placed on the read queue 
for that device; otherwise the event record is discarded. The information passed via the snap prim¬ 
itive can be displayed using the vpmsave and vpmfint commands (see vpmsave{lM)). 

rtnrpt(name) 

Return a report to the driver. Four bytes from the array specified by name are transferred to the 
driver. The process delays until the transfer is complete. 

testopiprimary) 

Test for odd parity. The returned value is true (non-zero) if the value of the primary expression 
has odd parity, otherwise the returned value is false (zero). 

timeout (pr/ma ry) 

Schedule or cancel a timer interrupt. If the value of the primary expression is non-zero, the current 
values of the program counter and stack pointer are saved and a timer is loaded with the value of 
the primary expression. The system call then returns immediately with a value of false (zero) as 
the returned value. The timer is decremented each tenth of a second thereafter. If the timer is 
decremented to zero, the saved values of the program counter and stack pointer are restored and 
the system call returns with a value of true (non-zero). The effect of the timer interrupt is to 
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return control to the code immediately following the timeout system call, at which point a non¬ 
zero return value indicates that the timer has expired. The timeout system call with a non-zero 
argument is normally written as the condition part of an if statement. A timeout system call with 
a zero argument value cancels all previous timeout requests, as does a return from the function in 
which the timeout system call was made. A timeout system call with a non-zero argument value 
overrides all previous timeout requests. The maximum permissible value for the argument is 255, 
which gives a timeout period of 25.5 seconds. 

timeriprimary) 

Start a timer or test for timer expiration. If the value of the primary expression is non-zero, a soft¬ 
ware timer is loaded with the value of the primary expression and a value of true (non-zero) is 
returned. The timer is decremented each tenth of a second thereafter until it reaches zero. If the 
value of the primary expression is zero, the returned value is the current value of the timer; this 
will be true (non-zero) if the value of the timer is currently non-zero, otherwise false (zero). The 
timer used by this primitive is different from the timer used by the timeout primitive. 

trace(primary[,primary]) 

The values of the two primary expressions and the current value of the script location counter are 
passed to the driver, which prehxes a sequence number and creates a trace event record containing 
the data. If minor device 0 of the trace driver is currently open, the record is placed on the read 
queue for that device; otherwise the event record is discarded. The information passed via the 
trace primitive can be displayed using the vpmsave and vpmfint commands (see vpmsave(IM)). If 
the second argument is omitted, a zero is used instead. The process delays until the values have 
been accepted by the host computer. 

Constants 

A constant is a decimal, octal, or hexadecimal integer, or a single character enclosed in single quotes. A 
token consisting of a string of digits is taken to be an octal integer if the hrst digit is a zero, otherwise the 
string is interpreted as a decimal integer. If a token begins with Ox or OX, the remainder of the token is 
interpreted as a hexadecimal integer. The hexadecimal digits include a through f or, equivalently, A 
through F. 

Variables 

Variable names may be used without having been previously declared. All names are global. All values 
are treated as 8-bit unsigned integers. 

Arrays of contiguous storage may be allocated using the array declaration: 
array name [constant] 

where constant is a decimal integer. Elements of arrays can be referenced using constant subscripts: 
name [constant] 

Indexing of arrays assumes that the first element has an index of zero. 

Names 

A name is a sequence of letters and digits; the first character must be a letter. Upper- and lower-case letters 
are considered to be distinct. Names longer than 31 characters are truncated to 31 characters. The under¬ 
score (_) may be used within a name to improve readability, but is discarded by RATFOR. 

Preprocessor Commands 

If the -m option is omitted, comments, macro dehnitions, and hie inclusion statements are written as in C. 
Otherwise, the following rules apply: 

1. If the character # appears in an input line, the remainder of the line is treated as a comment. 

2. A statement of the form: 

dehne(nflme Jext) 

causes every subsequent appearance of name to be replaced by text. The dehning text includes 
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everything after the comma up to the balancing right parenthesis; multi-line definitions are allowed. 
Macros may have arguments. Any occurrence of $n within the replacement text for a macro will be 
replaced by the nth actual argument when the macro is invoked. 

3. A statement of the form: 

include(^/e) 

inserts the contents of file in place of the include command. The contents of the included file is often 
a set of definitions. 

EXAMPLES 

These examples require the use of the -m option. 

# The function defined below transmits a frame in transparent BISYNC. 

# A transmit buffer must be obtained with getxbuf before the function 

# is invoked. 

# 

# Define symbolic constants: 

# 

define(DLE,Ox 10) 
define(ETB ,0x26) 
define(PAD,Oxff) 
define(STX,0x02) 
define(SYNC,0x32) 

# 

# Define a macro with an argument: 

# 

define(xmtcrc, {crc 16($ 1); xmt($ 1);}) 

# 

# Declare an array: 

# 

array crc[2]; 

# 

# Define the function: 

# 

function xmtblk() 

crcloc(crc); 

xsom(SYNC); 

xmt(DLE); 

xmt(STX); 

while(get(byte)==0) { 

if(byte == DEE) 

xmt(DLE); 

xmtcrc(byte); 

} 

xmt(DLE); 

xmtcrc(ETB); 

xmt(crc[0]); 

xmt(crc[l]); 

xeom(PAD); 

end 

# 

# The following example illustrates the use of macros to simulate a 

# function call with arguments. 

# 
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# The macro definition: 

# 

define(xmtctl, {c=$ 1 ;d=$2;xmtctll ()}) 

# 

# The function definition: 

# 

function xmtctll() 

xsom(SYNC); 
xmt(c); 
if(d!=0) 

xmt(d); 
xeom(PAD); 

end 
# 

# Sample invocation: 

# 

function test() 

xmtctl(DLE,0x70); 

end 

FILES 

sas_temp* 

/tmp/sas_ta?? 

/tmp/sas_tb?? 

/usr/lib/vpm/pass* 

/usr/lib/vpm/pl 
/usr/lib/vpm/vratfor 
/lib/cpp 
/usr/bin/m4 
/bin/kasb 

/usr/lib/vpm/bisync/* 

/usr/lib/vpm/hdlc/* 

SEE ALSO 

m4(l), ratfor(l), vpmsave(lM), vpm(7). 

C Reference Manual by D. M. Ritchie. 

RATFOR-A Preprocessor for a Rational Fortran by B. W. Kernighan. 
The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 
Software Tools by B. W. Kernighan and P. J. Plauger (pp. 28-30). 


temporaries 
temporary 
temporary 
compiler phases 
compiler phase 
compiler phase 
preprocessor 
preprocessor 
KMC 11 -B assembler 

interpreter source for the BISYNC interpreter 
interpreter source for the HDLC interpreter 
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NAME 

vpmc - compiler for the virtual protocol machine 
SYNOPSIS 

vpmc [ -m ] [ -c ] [ -s sfile ] [ -1 Ifile ] [ -o ofile ] file 
DESCRIPTION 

Vpmc is the compiler used for C programs written to describe communications link protocols. The output 
of vpmc is a load module for the virtual protocol machine (VPM), which is a software construct for imple¬ 
menting communications link protocols (e.g., BISYNC) on the UN53) device. VPM is implemented by a 
program in the UN53 which cooperates with a driver in the UNIX System host computer to transfer data 
over a communications link in accordance with a specified link protocol. The UNIX System user processes 
transfer data to or from a remote terminal or computer system through VPM using normal UNIX System 
open, read, write, and close operations. The VPM program in the UN53 provides error control and flow 
control using the conventions specified in the protocol. 

Options 

The meanings of the command-line options are: 

-m Use m4(l) instead of cpp as the macro preprocessor. 

-c Compile only (suppress the assembly and linking phases). 

-s sfile Save the generated assembly language on file sfile. 

-1 Ifile Produce an assembly-language listing on file Ifile. 

-o ofile Write the executable object file on file ofile (default a.out). 

These options may be given in any order. 

Programs 

Input to vpmc consists of a C program with one or more function definitions. The first defined function is 
invoked (on command from the driver) to begin program execution. 

System Calls 

A VPM program interacts with a communications device and a driver in the host computer by means of sys¬ 
tem calls (primitives). 

The following primitives are available: 

atoeiprimary) 

Translate ASCII to EBCDIC. The returned value is the EBCDIC character that corresponds to the 
ASCII character represented by the value of the primary expression. The translation tables reflect 
the prejudices of a particular installation. 

crcl6(primary) 

The value of the primary expression is combined with the cyclic redundancy check-sum at the 
location passed by a previous crcloc system call. The CRC-16 polynomial +x^ + 1) is 

used for the check-sum calculation. 

crcloc(name) 

The two-byte array starting at the location specified by name is cleared. The address of the array 
is recorded as the location to be updated by subsequent crcl6 system calls. 

etoaiprimary) 

Translate EBCDIC to ASCII. The returned value is the ASCII character that corresponds to the 
EBCDIC character represented by the value of the primary expression. The translation tables 
reflect the prejudices of a particular installation. 

gei{lvalue) 

Get a byte from the current transmit buffer. The next available byte, if any, is copied into the 
location specified by lvalue. The returned value is zero if a byte was obtained, otherwise it is 
non-zero. 
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getrbuf(name) 

Get (open) a receive buffer. The returned value is zero if a buffer is available, otherwise it is non¬ 
zero. If a buffer is obtained, the buffer parameters are copied into the array specified by name. 
The array should be large enough to hold at least three bytes. The meaning of the buffer parame¬ 
ters is driver-dependent. If a receive buffer has previously been opened via a getrbuf call but has 
not yet been closed via a call to rtnrbuf, it is reinitialized and remains the current buffer. 

getxbuf(name) 

Get (open) a transmit buffer. The returned value is zero if a buffer is available, otherwise it is 
non-zero. If a buffer is obtained, the buffer parameters are copied into the array specified by 
name. The array should be large enough to hold at least three bytes. The meaning of the buffer 
parameters is driver-dependent. If a transmit buffer has previously been opened via a getxbuf call 
but has not yet been closed via a call to rtnxbuf, it is reinitialized and remains the current buffer. 

putiprimary) 

Put a byte into the current receive buffer. The value of the primary expression is inserted into the 
next available position, if any, in the current receive buffer. The returned value is zero if a byte 
was transferred, otherwise it is non-zero. 

rcv(lvalue) 

Receive a character. The process delays until a character is available in the input silo. The charac¬ 
ter is then moved to the location specified by lvalue and the process is reactivated. 

r&om{constant) 

Skip to the beginning of a new receive frame. The receiver hardware is cleared and the value of 
constant is stored as the receive sync character. This call is used to synchronize the local receiver 
and remote transmitter when the process is ready to accept a new receive frame. 

rtnrbuf(name) 

Return a receive buffer. The original values of the buffer parameters for the current receive buffer 
are replaced with values from the array specified by name. The current receive buffer is then 
released to the driver. 

rtnxbuf(name) 

Return a transmit buffer. The original values of the buffer parameters for the current transmit 
buffer are replaced with values from the array specified by name. The current transmit buffer is 
then released to the driver. 

xeom{constant) 

Transmit end-of-message. The value of the constant is transmitted, then the transmitter is shut 
down. 

xmtiprimary) 

Transmit a character. The value of the primary expression is transmitted over the communications 
line. If the output silo is full, the process waits until there is room in the silo. 

xsom{constant) 

Transmit start-of-message. The transmitter is cleared, then the value of constant is transmitted six 
times. This call is used to synchronize the local transmitter and the remote receiver at the begin¬ 
ning of a frame. 

dsrwait() 

Wait for modem-ready and then set modem-ready mode. The process delays until the modem- 
ready signal from the modem interface is asserted. If the modem-ready signal subsequently drops, 
the process is terminated. If dsrwait is never invoked, the modem-ready signal is ignored. 

exitiprimary) 

Terminate execution. The process is halted and the value of the primary expression is passed to 
the driver. 
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getcmd(name) 

Get a command from the driver. If a command has been received from the driver since the last 
call to getcmd, four bytes of command information are copied into the array specified by name 
and a value of true (non-zero) is returned. If no command is available, the returned value is false 
(zero). 

pause( ) Return control to the dispatcher. This primitive informs the dispatcher that the virtual process may 
be suspended until the next occurrence of an event that might affect the state of the protocol for 
this line. Examples of such events are: (1) completion of an output transfer, (2) completion of an 
input transfer, (3) timer expiration, and (4) a buffer-in command from the driver. In a multi-line 
implementation, the pause primitive allows the process for a given line to give up control to allow 
the processor to service another line. In a single-line implementation this primitive has no effect. 

snap(name) 

Create a snap event record. Four bytes from the array specified by name are passed to the driver, 
which prefixes a time stamp and sequence number and creates a trace event record containing the 
data. If minor device 1 of the trace driver is currently open, the record is placed on the read queue 
for that device; otherwise the event record is discarded. The information passed via the snap prim¬ 
itive can be displayed using the vpmsnap command (see vpmstart). 

rtnrpt(nflme) 

Return a report to the driver. Four bytes from the array specified by name are transferred to the 
driver. The process delays until the transfer is complete. 

testop(pnmary) 

Test for odd parity. The returned value is true (non-zero) if the value of the primary expression 
has odd parity, otherwise the returned value is false (zero). 

timeoutiprimary) 

Schedule or cancel a timer interrupt. If the value of the primary expression is non-zero, the current 
values of the program counter and stack pointer are saved and a timer is loaded with the value of 
the primary expression. The system call then returns immediately with a value of false (zero) as 
the returned value. The timer is decremented each tenth of a second thereafter. If the timer is 
decremented to zero, the saved values of the program counter and stack pointer are restored and 
the system call returns with a value of true (non-zero). The effect of the timer interrupt is to 
return control to the code immediately following the timeout system call, at which point a non¬ 
zero return value indicates that the timer has expired. The timeout system call with a non-zero 
argument is normally written as the condition part of an if statement. A timeout system call with 
a zero argument value cancels all previous timeout requests, as does a return from the function in 
which the timeout system call was made. A timeout system call with a non-zero argument value 
overrides all previous timeout requests. The maximum permissible value for the argument is 255, 
which gives a timeout period of 25.5 seconds. 

timeriprimary) 

Start a timer or test for timer expiration. If the value of the primary expression is non-zero, a soft¬ 
ware timer is loaded with the value of the primary expression and a value of true (non-zero) is 
returned. The timer is decremented each tenth of a second thereafter until it reaches zero. If the 
value of the primary expression is zero, the returned value is the current value of the timer; this 
will be true (non-zero) if the value of the timer is currently non-zero, otherwise false (zero). The 
timer used by this primitive is different from the timer used by the timeout primitive. 

traceiprimary [,primary]) 

The values of the two primary expressions and the current value of the script location counter are 
passed to the driver, which prefixes a sequence number and creates a trace event record containing 
the data. If minor device 0 of the trace driver is currently open, the record is placed on the read 
queue for that device; otherwise the event record is discarded. The information passed via the 
trace primitive can be displayed using the vpmtrace command (see vpmsave). If the second argu¬ 
ment is omitted, a zero is used instead. The process delays until the values have been accepted by 
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the host computer. 

Preprocessor Commands 

If the -m option is omitted, comments, macro definitions, and file inclusion statements are written as in C. 
Otherwise, the following rules apply: 

1. If the character # appears in an input line, the remainder of the line is treated as a comment. 

2. A statement of the form: 

define(name ,fexf) 

causes every subsequent appearance of name to be replaced by text. The defining text includes every¬ 
thing after the comma up to the balancing right parenthesis; multi-line definitions are allowed. Macros 
may have arguments. Any occurrence of $n within the replacement text for a macro will be replaced 
by the nth actual argument when the macro is invoked. 

3. A statement of the form: 

include(^fe) 

inserts the contents of file in place of the include command. The contents of the included file is often 
a set of definitions. 

SEE ALSO 

m4(l), vpmset(lM). 

C Reference Manual by D. M. Ritchie. 

The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 

Software Tools by B. W. Kernighan and P. J. Plauger (pp. 28-30). 
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NAME 

vpmsave, vpmfmt - save and print VPM event traces 

SYNOPSIS 

/etc/vpmsave mask device 
/etc/vpmfmt [-t] 

DESCRIPTION 

Vpmsave opens the minor device of the trace driver specified by device, enables the channels specified by 
mask (octal), and then reads event records and writes them to its standard output (unformatted) until killed. 
Bit 0 of mask enables channel zero, bit 1 channel one, etc. The Common Synchronous Interface (CSI) rou¬ 
tines and the CSTbased protocol drivers use the CSI index number (modulo 16) to select their trace chan¬ 
nels. Each protocol driver provides an ioctl command that can be used to get this number. 

Vpmfmt reads its standard input, which it assumes was generated by vpmsave, and prints it (formatted) to its 
standard output until killed. The -t option when used with the level 2 script trcslapb.r provides a detailed 
event trace of the operation of level 2 of BX.25. When used with other scripts the result may not be mean¬ 
ingful. 

Support for the commands vpmtrace and vpmsnap has been dropped. The function of vpmtrace can be 
obtained using vpmsave and vpmfmt as follows: 

vpmsave mask device I vpmfmt 

where device is the name of minor device 0 of the trace driver. 

The event records generated by calls to the vpmc snap primitive are now directed to minor device 0 along 
with other event records. The need to keep the snap event record separate no longer exists since all event 
records now contain a time stamp. 

EXAMPLE 

vpmsave mask device > t & 
vpmfmt < t 

SEE ALSO 

vpmc(lM), trace(7), vpm(7). 
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NAME 

vpmset, vpmstart - connect/load VPM drivers and programmable communication devices 

SYNOPSIS 

/etc/vpmset [ -b ] [ -d ] [ -s ] tdev pdev [ lineno ] 

/etc/vpmstart [ -r ] device n [ filen ] 

DESCRIPTION 

The vpmset command provides a means for associating dynamically a VPM protocol driver minor device 
with a particular synchronous line on a programmable communication device (PCD). Tdev is the protocol 
driver minor device name; pdev is the PCD minor device name; and lineno is the number of a synchronous 
line if a DEC KMSll was specified. Until these connections have been made, a user program cannot open 
the VPM protocol driver minor device for reading or writing. 

The -b option causes bit zero of the protocol option bits to be set. Some protocol scripts such as cslapb.r 
(level 2 of BX.25) use this bit to specify address B as the local address. These bits are stored by the proto¬ 
col driver and passed to the PCD when the VPM protocol minor device is opened for reading and/or writing. 
These bits are available to the protocol script via the getopt primitive. 

The -d option disconnects the VPM protocol minor device from the synchronous line on the PCD. This dis¬ 
connect will fail if the VPM protocol minor device is open for reading and/or writing. 

The -s option prints to stdout a message indicating which Common Synchronous Interface (CSI) index is 
associated with the protocol minor device. This number modulo 16 indicates the channel number used for 
tracing events with the vpmsave{\M) command. 

Vpmstart wntes filen (a.out by default) to the KMCll(DEC) or UN53(3B20S) specified by device. The argu¬ 
ment n is a magic number that the PCD driver saves to identify the program. This number is checked when 
the VPM driver is opened to provide some assurance that the program loaded into the PCD is the one 
expected. The magic number for any standard VPM program running in the PCD is 6 (7 indicates a V.35 
interface on the 3B20S). While may be any file that is executable by the PCD, it will normally have 
been prepared using vpmc (IM). 

The PCD control program waits for the VPM protocol minor device to be opened for reading and/or writing 
before beginning execution of the protocol script. The -r option may be specified only when using a DEC 
KMCll. When this option is specified, the queue of commands to the KMC 11 driver is not flushed prior to 
starting the PCD program. This option must be used to reload the KMCll when recovering from a power- 
fail. 

SEE ALSO 

vpm(7), vpmc(lM). 
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NAME 

vpmtest - test KMC lines 

SYNOPSIS 

/etc/vpmtest -t top -k kmc -n line 
DESCRIPTION 

Vpmtest performs a series of loopback tests on a specified synchronous line interface of a specified KMC. 
Top is a path name that specifies the VPM protocol driver minor device to be used for the test. Kmc is the 
path name for the KMC on which the test is to be run. Line specifies the particular line number (0-7) on a 
KMS; for a KMC equipped with a single-line line interface line should be 0. The KMC must have been pre¬ 
viously loaded with the LAPB script (cslapb.r) using vpmstart. The top device must not be open for read¬ 
ing or writing; this is the same restriction as for doing a vpmset. The equivalent of a vpmset is performed to 
associate the specified top device with the specified KMC and line number. 

The first test uses the maintenance mode of the line unit hardware to perform an internal loopback test; this 
test is independent of the modem to which the line is attached. A failure at this point indicates a problem 
with the KMC or line unit hardware or with the VPM or KMC software. The second test requires the local 
(near end) modem to be placed in the analog loopback mode; on a WECO 209A dataset this is accomplished 
by depressing the AL button on the front of the dataset. A failure at this point indicates a problem with the 
modem or with the interface between the modem and the line unit; a faulty or disconnected cable is the 
most likely possibility. The third test performs a loopback from the remote (far end) modem. This requires 
placing the remote modem in the digital loopback mode; on a WECO 209A dataset this is accomplished by 
depressing the DL button on the front of the dataset. The local (near end) modem should be in the normal 
mode for this test. A failure at this point indicates trouble with one or both of the modems or with the tele¬ 
phone line connecting them. At the end of each test the VPM error counters associated with the particular 
line are printed. 

EXAMPLE 

/etc/vpmtest-t /dev/vpml -k /dev/kmc 1 -n 7 

SEE ALSO 

kmc(7), vpm(7). 
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NAME 

wall - write to all users 

SYNOPSIS 

/etc/wall 

DESCRIPTION 

Wall reads its standard input until an end-of-file. It then sends this message to all currently logged in users 
preceded by: 

Broadcast Message from ... 

It is used to warn all users, typically prior to shutting down the system. 

The sender must be super-user to override any protections the users may have invoked (see mesg{l)). 

PILES 

/dev/tty* 

SEE ALSO 

mesg(l), write(l). 

DIAGNOSTICS 

“Cannot send to ...” when the open on a user’s tty hie fails. 
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NAME 

whodo - who is doing what 

SYNOPSIS 

/etc/whodo 

DESCRIPTION 

Whodo produces merged, reformatted, and dated output from the who{\) andps(l) commands. 

SEE ALSO 

ps(l), who(l). 


Page 1 



X25PVC(1M) 


X25PVC(1M) 


NAME 

x25pvc, x251nk - install, remove, or get status for a BX.25 minor device or link 

SYNOPSIS 

/etc/x25pvc options 

/etc/x251nk options 

DESCRIPTION 

X25pvc may be used to install or remove a BX.25 Permanent Virtual Circuit (PVC) on a specified BX.25 
interface (link), or to display the status of a specified BX.25 minor device (slot). Exactly one of the follow¬ 
ing options (i.e. -i, -r, -s, -e) must be used: 

~i [ “S ] [ ] -m slotname -c chno -1 linkno 

Slotname is a path name that specihes a BX.25 minor device (slot). If that minor device is cur¬ 
rently connected to some logical channel on some BX.25 interface (link), then hrst that minor 
device will be removed, if possible (see the -r option). If that minor device is now available, it is 
connected to logical channel chno on link number linkno. Chno must be in the range of 1 to 4,095 
and must not currently be in use for any other BX.25 minor device associated with that link. 
Exactly one of three session-establishment options must be used: -S, which is the preferred option, 
indicates that session-layer connect/accept/disconnect qualihed data messages are to be used; -R 
indicates that RESET in-order/out-of-order packets will be recognized but not transmitted; -N indi¬ 
cates that the ‘ ‘no protocol’ ’ session mode will be used. The -R and -N options are provided only 
for compatibility with non-UNIX system implementations of BX.25. This command will fail if the 
link, channel, or minor device number is out of range, or if the slot is in use. 

-r slotname 

Remove the association between BX.25 minor device slotname and the link and channel number to 
which it is currently connected. The command will fail if the minor device number is out of range, 
the slot is not installed, the slot is open, packets are waiting to be transmitted, or there are unac¬ 
knowledged packets outstanding. 

-S slotname 

Print abbreviated status information for BX.25 minor device slotname. The information printed 
consists of slotname, the logical channel number, the link number, and the session-establishment 
option. This command will fail if the minor device number is out of range or the slot is not 
installed. 

-e slotname 

Print extended status information for BX.25 minor device slotname. The information printed con¬ 
sists of most of the information that is stored in the internal data structures associated with this 
device. This information is useful for determining the state of the PVC associated with this device 
when hardware or software anomalies are suspected and is intended for use by developers and 
sophisticated users. This command will fail if the minor device number is out of range or the slot 
is not installed. 

X25lnk is used to attach, detach, activate, deactivate, get status for and perform a changeover on a specihed 
BX.25 interface (link). Exactly one of the following options (i.e. -a, -d, -i, -h, -s, -c) must be used: 

-a [ -k ] -m device [ -n lineno ] [ -o modctl ] -1 linkno 

Attach the BX.25 link that is specihed by linkno to the level 2 device whose name is device. This 
command makes the necessary connections between data structures. Linkno is the number of the 
BX.25 link to be attached; links are numbered starting with 0. If a line number must be specihed 
for the device, (e.g. the device is a KMSll), the -n option is used. If the device is a KMSll and 
modem control is needed, the -o option is used and modctl is the path name of the DM 11-BA 
modem control unit associated with a particular KMC as part of a KMSl 1. If the -k option is used, 
this command will attach device as a backup for link linkno', otherwise, device is the primary. This 
command will fail if the link number is out of range, the link is already attached, or the device is 
already attached. 
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-d [ -k ] -1 linkno 

Detach the BX.25 link that is specified by linkno. This command removes the logical connections 
that were made by the -a option. If the -k option is used, this command will detach the backup 
device associated with linkno', otherwise the primary device is detached. This command will fail if 
the link number is out of range, the device is not attached, or the device has not been halted. 

-i [ -k ] [ -b ] [ -p pktsize ] [ -f ] -1 linkno 

Activate the BX.25 link that is specified by linkno. The -b option specifies that the link-level pro¬ 
tocol will use address B; the default is address A. The -p option specifies the packet size; if it is 
used, pktsize must be a number that is a power of 2 and lies between 16 and 1,024 inclusive. The 
default packet size is 128. The -f option, which is used only on the 3B20S, indicates that the 
speed of the device associated with link linkno is greater than 9.6KB. If the -k option is used, this 
command will start the level 2 protocol on the backup device associated with link linkno', other¬ 
wise, the BX.25 level 2 and level 3 protocols will be started on the primary device associated with 
link linkno. This command will fail if the link number is out of range, the link is not attached, the 
device is already started, or the packet size is invalid. 

-h [ -k ] -1 linkno 

Halt the link specified by linkno. If the -k option is used, the level 2 protocol on the backup 
device will be stopped provided the level 3 protocol is not running on the backup device. If the -k 
option is not used, the level 3 protocol is stopped (wherever it is running) and the level 2 protocol 
on the primary device is stopped. If a backup device has been attached and started, the level 2 pro¬ 
tocol on the backup will also be stopped. This command will fail if the link number is out of range 
or the link is not attached. 

-s -1 linkno 

Print the status of the link specified by linkno. The information printed consists of the link num¬ 
ber, the packet size used on that link, and internal status information including whether or not the 
level 2 queue is full, the restart state of the link, whether or not the high and low priority queues 
are empty, and whether or not a restart packet is on the level 2 queue. Information about level 2 
status is printed for the primary device and also for the backup device, if it has been attached. The 
value of csidev modulo 16 indicates the channel number used for tracing events with the vpmsave 
command. This command will fail if the link number is out of range or the link is not attached to 
either a primary or backup device. 

-c -1 linkno 

Changeover to the standby synchronous device associated with link linkno. If the standby device 
is synchronized at level 2, level 3 will now run on that device. This command will fail if the link 
number is out of range, the link is not attached to both a primary and backup device, or a backup 
device has not been started. 

SEE ALSO 

vpmsave(lM), nc(7), x25(7). 
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NAME 

intro - introduction to special files 

DESCRIPTION 

This section describes various special files that refer to specific hardware peripherals and UNIX System 
device drivers. The names of the entries are generally derived from names for the hardware, as opposed to 
the names of the special files themselves. Characteristics of both the hardware device and the correspond¬ 
ing UNIX System device driver are discussed where applicable. 

BUGS 

While the names of the entries generally refer to vendor hardware names, in certain cases these names are 
seemingly arbitrary for various historical reasons. 
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NAME 

acu, dn - Automatic Call Unit (ACU) interface 

DESCRIPTION 

The ACU drivers support open, close, and write system calls. In addition, the UN56 driver on the 3B20S 
supports an ioctl system call. The acu? and dn? files are write-only. The write system call sends the tele¬ 
phone number to be dialed to the ACU. The permissible codes are: 


0-9 

dial 0-9 

* or: 

dial * 

# or; 

dial # 

- 

4 second delay for second dial tone 

e or < 

end-of-number 

w or = 

wait for secondary dial tone 

f 

hash off hook for 1 second 


The entire telephone number must be presented in a single write system call. 

The ioctl system call {UN56 only) is invoked as follows: 

#include <sys/un56 h> 
int hides, cmd; 
struct acutab *acutp; 
ioctl (hides, cmd, acutp); 

Acutab is a table specifying the connections between ACU minor devices and communication lines: 

struct acutab { 

int minor; 
int unit; 
int port; 
int line; 

} acutab[]; 

The ioctl cmds are: 

ACUSDEV-Specify a connection between an ACU minor device and a telephone line. This command 
makes an entry in acutab, the table that specihes associations between ACU minor devices and 
dial-out lines. Before the ACUs can be used, and after any ACU reconhguration, this table must be 
sent to the ACU peripheral controller via the ACUSTART command. 

ACUSTART-Connect ACU minor devices to telephone lines. This command informs the ACU peripheral 
controller of the connections set up by the ACUSDEV command and enables it. 

SEE ALSO 

acuset(lM). 

EILES 

/dev/acu* (3B20S only) 

/dev/un56 (3B20S only) 

/dev/dn* (DEC only) 
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NAME 

cat - phototype setter interface 

DESCRIPTION 

Cat provides the interface to a Wang Laboratories, Inc. C/A/T phototypesetter. Bytes written on the file 
specify font, size, and other control information as well as the characters to be flashed. The coding will not 
be described here. 

Only one process may have this file open at a time. It is write-only. 

PILES 

/dev/cat 

SEE ALSO 

troff(l). 
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NAME 

dgn - on-line diagnostic interface 

DESCRIPTION 

Files in the directory /dev/dgn provide the interface between on-line diagnostic commands and device 
drivers. The files in this directory are intended to be accessed only by diagnostic commands. 

EILES 

/dev/dgn/* 

SEE ALSO 

abt(lM), chmap(lM), dgn(lM), dstart(lM), rmv(lM), rst(lM), sta(lM). 

WARNING 

Diagnostic commands are intended for use only by trained hardware maintenance personnel. 


Page 1 



DMC(7) 


(DEC only) 


DMC(7) 


NAME 

dmc - communications link with built-in DDCMP protocol 

DESCRIPTION 

The DMC 11 allows local connection of PDP-11 systems over high-speed (1Mb or 56kb) links and remote 
connection over leased (up to 19.2kb) or dial-up (up to 4,800b) lines. It implements in hardware the 
DDCMP data-link protocol, which includes error control. This driver handles two DMCl 1 devices. 

EILES 

/dev/dmc 

BUGS 

There are quite a few bugs in the DEC microcode for the different versions of the DMC 11. 
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NAME 

dmk - DMl 1-BA modem control multiplexor 

DESCRIPTION 

The files /dev/dmk? are used to access DMl 1-BA modem control units. Each DMl 1-BA provides modem 
control and status information for eight synchronous lines. The DMl 1-BA is an optional component of the 
KMSll communications processor (see vpm(7)). Since the VPM software for the KMSll does not provide 
any access to the DM 11-BA, it is necessary to use the dmk driver if modem control is required with the 
KMSll. 

The ioctl(2) function is used to provide access to the basic modem control capabilities: 

#include <sys/dmk h> 
ioctl (hides, command, arg) 
struct dmkctl { 

short line; 
short mode; 

} *arg; 

The only command available is DMKSETM. The effect of this command is to set the control leads in the 
modem interface for the line (0-7) specihed by line to the state specihed by mode. The bits in mode specify 
control leads to be asserted as follows: 


Name 

Bit 

Meaning 

DMKDTR 

002 

Data Terminal Ready 

DMKRTS 

004 

Request to Send 

DMKNS 

010 

New Sync 


PILES 

/dev/dmk? 

SEE ALSO 

x25pvc(lM), vpm(7). 

"KMSll-A/B Communications Processor Option Description", YM-C126C-00, Digital Equipment Corpo¬ 
ration. 

"DMl 1-BA Modem Control Multiplexor Option Description", YM-C138C-00, Digital Equipment Corpora¬ 
tion. 
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NAME 

dsk - 3B20S moving-head disk 

DESCRIPTION 

Two types of disk drives, 300 megabyte and 675 megabyte, are each divided into 16 sections. The files 
dskO, ..., dskS, ..., dskf refer to sections (a hexadecimal digit in the name) of the disk drive unit number 0. 
The files dsklO, ..., dsklS, ..., dsklf refer to drive unit number 1, etc. This slicing allows the pack to be 
broken up into more manageable pieces. 

The origin and size of the sections on each type of drive are as follows: 

300 Mbyte 675 Mbyte 


section 

start 

length 

start 

length 

0 

1 

494304 

1 

1070080 

1 

101 

433504 

101 

942080 

2 

251 

342304 

251 

750080 

3 

326 

296704 

326 

654080 

4 

476 

205504 

476 

462080 

5 

551 

159904 

551 

366080 

6 

701 

68704 

701 

174080 

7 

775 

23712 

776 

78080 

8 

0 

495520 

0 

1072640 

13 

204 

370880 

210 

802560 

14 

407 

247456 

419 

535040 

15 

610 

124032 

628 

267520 


The start address is a cylinder address and the length is in disk (512 byte) blocks. Each cylinder contains 
608 disk blocks on the 300 megabyte drive and 1280 disk blocks on the 675 megabyte drive. There are 815 
usable cylinders on the 300 megabyte drive and 838 usable cylinders on the 675 megabyte drive. Also it 
should be noted that the first cylinder is reserved for booting and the last cylinder for diagnostics. 

Sections 0 through 7 and 13 through 15 define file system space to be used according to local needs. Sec¬ 
tions 9 through 12 define special use slices of the disk. Section 8 covers the entire usable area of the disk 
(including the boot and diagnostic cylinders). Sections 13 through 15 define slices that quarter the disk. 
The usable sections (0-7 and 13 - 15) define overlapping disk slices and care must taken in choosing a set 
for file systems on a disk. A section is no longer usable if the file system defined on the previous section 
overlaps it. 

The dsk files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw disk files begin with rdsk and end with a number which selects the same disk section as 
the corresponding dsk file. 

In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 64 bytes. The I/O 
must start on a disk block boundary. 

In addition to the sections defined above two other special files have been created to define areas on the 
disk. The first is /dev/dump? (section 10), where ? is the disk unit number, which provides raw access to 
the section on the disk where dumps will be put. The second file is /dev/boot? (section 9) which provides 
raw access to the boot section. 

EILES 

/dev/dsk*, /dev/rdsk*, /dev/dump?, /dev/boot? 


Page 1 



DU(7) 


(PDP-11 only) 


DU(7) 


NAME 

du - DU-11 synchronous line interface 
DESCRIPTION 

The hies duO, dul, etc., represent interfaces to synchronous modems such as the Bell System 200-series 
synchronous DATA-PHONE nh 

sets. Read and write calls to du? are unlimited, but work best when restricted to less than 512 bytes. Each 
write call is sent as a single record. Seven bits from each byte are written, along with an eighth, odd-parity, 
bit. The “sync” characters must be supplied by the user. Each read call returns the characters read from a 
single record. Seven bits are returned unaltered; the eighth bit is set if the byte was not received in odd par¬ 
ity. An error is returned if data-set ready is not present. 

PILES 

/dev/du? 

SEE ALSO 

acu(7). 


Page 1 



DZ(7) 


(DEC only) 


DZ(7) 


NAME 

dz, dzb, dh - DZ-11, DZ-ll/KMC-llB, DH-11 asynchronous multiplexers 

DESCRIPTION 

Each line attached to a DH-11 or DZ-11 communications multiplexer behaves as described in termio{l). 
Input and output for each line may independently be set to run at any of 16 speeds; see termio{l) for the 
encoding. (For DZ-11 lines, output speed is always the same as input speed. The 200 speed and the two 
externally clocked speeds {exta, extb) are missing on the DZ-11.) The behavior of dzb lines is indistin¬ 
guishable from that of dz lines, except that on the dzb backspace delays are implemented using hll charac¬ 
ters (rubouts) instead of timed delays. 

Note that the DH-11 is considered obsolete and is not supported on the VAX-11/780. 

EILES 

/dev/tty* 

SEE ALSO 

kmc(7), termio(7). 
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NAME 

emulio - 3270 emulation interface 

SYNOPSIS 

#include <sys/file h> 

DESCRIPTION 

3270 emulation makes use of the UN53 driver and associated VPM software to simulate a 3270-type con¬ 
troller (e.g., a 40/4 controller). Users may communicate with a remote host as a 3270-type peripheral (e.g., 
a 40/4 terminal) through terminal emulation special files. 3270 emulation consists of two UNIX System 
drivers and a protocol script. The emc driver provides an administrative interface to the "controller". The 
em driver provides the users interface to the remote system. The protocol script runs in the UN53 and han¬ 
dles the line protocol. Both ASCII (/lib/a3270scr), and EBCDIC (/lib/e3270scr) scripts are available. All 
structures described here are defined in <sys/em.h>. 

Administrative Interface 

This section describes the interface to the emc driver. Each emulated controller is represented by a charac¬ 
ter special file (/dev/emc?). To use 3270 emulation the emc device must be associated (using vpmset) with 
the physical device to be used. For example to associate controller 2 and device 3: 

/etc/vpmset /dev/emc2 /dev/un53.3 

The appropriate protocol script must also be loaded (using vpmstart) on the physical device. For example, 
to load the EBCDIC script on device 3: 

/etc/vpmstart /dev/un53.3 6 /lib/e3270scr 

The remaining administrative functions are performed using ioctl(2) calls on the emc device. The valid 
ioctl requests and the corresponding arg are as follows: 

EMCNTRS Return script error counters. Arg must be the address of a counters structure (see below). 

EMINEO Return information about this controller. Arg must be the address of a information structure 

(see below). 

EMPOLL Set the polling character to arg. The default is space (controller 0). 

EMSELECT Set the selection character to arg. The default is - (controller 0). 

EMEOTD Set the time delay before transmitting EOT’s to arg/10 seconds. The default is 2 seconds. 
EMSTART Start the corresponding protocol script. 

EMHALT Halt the corresponding protocol script. 

EMSETEL Set the controller flags as specified in arg. 

EMCLRFL Clear the controller flags as specified in arg. 

If request is EMCNTRS, arg must be the address of a structure with the following format: 
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struct emcntrs { 


short 

rtmout; 

/* 3 sec rev timeouts *I 

short 

xtmout; 

/* 1.5 sec timeouts, getxbuf */ 

short 

ptmout; 

/* 1.5 sec timeout on POLL */ 

short 

rcvnak; 

/* NAK’s received */ 

short 

xmtnak; 

/* NAK’s transmitted */ 

short 

rcvenq; 

/* ENQ’s received */ 

short 

xmtenq; 

/* ENQ’s transmitted */ 

short 

crcerrs; 

/* CRC errors *I 

short 

roflo; 

/* receive blocks to large */ 

short 

rgarb; 

/* Junk receive messages */ 

short 

xgarb; 

/* Garbage xmit buffers */ 

short 

rparerr; 

/* Bad parity on rev blocks */ 

short 

xparerr; 

/* Bad parity on xmit bufs */ 

short 

Ircerrs; 

/* LRC errors */ 

short 

eotrmsg; 

/* EOT’s when block expected */ 

short 

cmgarb; 

/* Junk in LISTEN state *I 

short 

gmgarb; 

/* Junk in TRASH state *I 


}; 

If request is EMINFO, arg must be the address of a structure with the following format: 
struct eminfo { 

short em_flags; /* Flags */ 

short em_code; /* Code */ 

char em_staid; /* Polling character */ 

char em_termid; /* Selection character */ 

char em_rdev; /* Real device */ 

}; 


The values used in the emjiags 

field are: 


#define 

EMASC 

0x01 

/* The controller is ASCII */ 

#define 

EM_RUN 

0x02 

/* The controller is usable */ 

#define 

EMSTATS 

0x04 

/* The entrs are available */ 

#define 

EMRBUF 

0x08 

/* Rev buffers are needed */ 

#define 

EMSCERR 

0x10 

/* Script error (ERRTERM) */ 

#define 

EMSTERR 

0x20 

/* Startup error */ 

#define 

EMTRACE 

0x40 

/* Script tracing flag */ 

#define 

EMSTOK 

0x80 

/* Started OK */ 

In general, all administrative functions can be performed from user level by using the emulcntrl{\M) and 


emulstat(lM) commands. 

User Interface 

This section describes the interface to the em driver. The em driver represents each terminal on a controller 
as a character special file (/dev/emt*). Up to 32 terminals are allowed per controller. The minor device 
number of each terminal specifies the controller and terminal; The low-order 8 bits specify the terminal 
number, and the remaining high-order bits specify the controller number. The id character for each termi¬ 
nal is determined as follows: 


Term 

Id 

Term 

Id 

0 

SP 

16 

& 

1 

A 

17 

J 
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2 

B 

18 

K 

3 

C 

19 

L 

4 

D 

20 

M 

5 

E 

21 

N 

6 

F 

22 

O 

7 

G 

23 

P 

8 

H 

24 

Q 

9 

I 

25 

R 

10 

[0 

26 

] ! 

11 


27 

$ 

12 

< 

28 


13 

( 

29 

) 

14 

+ 

30 

* 

15 

I 1 

31 

—1 


Where 2 characters appear, the second is EBCDIC. UNIX System user processes use the terminal files to 
simulate active terminals. To start a terminal the appropriate device is opened. Data transfers are per¬ 
formed using read{2), and write(2). The EMCNTRS and EMINEO ioctl(2) requests described in the previ¬ 
ous section can be used in the same way with terminal files. The general operations are performed as fol¬ 
lows: 

Starting The open{2) call will wait for a physical connection to be established before returning. Immedi¬ 
ate return is obtained using the ENDELAY open flag. This call will fail if the connection is not 
available (with ENDELAY flag), or the terminal is already in use. 

Transfers Once a terminal has been opened, a user process may transmit a “screen” using write(2). Data 
written must be in the expected form (control fields, etc.) and must be surrounded by the start- 
of-text (STX) and end-of-text (ETX) or end-of-block (ETB) characters. When using the ETB end 
character, subsequent writes must complete the block according to the block protocol (i.e., the 
last block must end in ETX). The two bytes following the STX character (in the first block of a 
message) are reserved for the station and device identification characters. The proper values of 
these bytes are inserted by the driver, however the space in the block must be provided by the 
user. All block check characters are added internally. Remote messages are received using 
read{2). The format of these blocks is the same as received from the remote system (i.e., the 
blocks are passed directly). All line protocol, and verification is performed internally. Reads 
and writes will fail if the communications line has dropped. 

Stopping To deactivate a terminal, the corresponding device is simply closed. Currently, any messages to 
be received by a deactivated (closed) terminal device are discarded. 

EILES 

/dev/emc? 3270 emulation controller devices 

/dev/emt* 3270 emulation terminals 

/lib/a3270scr ASCII 3270 script 

/lib/e3270scr EBCDIC 3270 script 

SEE ALSO 

emulcntrl(lM), emulload(lM), emulstat(lM), vpmset(lM). 
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NAME 

err - error-logging interface 

DESCRIPTION 

Minor device 0 of the err driver is the interface between a process and the system’s error-record collection 
routines. The driver may be opened only for reading by a single process with super-user permissions. Each 
read causes an entire error record to be retrieved; the record is truncated if the read request is for less than 
the record’s length. 

EILES 

/dev/error special file 

SEE ALSO 

errdemon(lM). 
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NAME 

gd - general driver for moving-head disks 

DESCRIPTION 

Gd provides a general interface to the RM05, RM80, RP04, RP04, RP05, RP06, and RP7 moving head disks. 
In addition to the capability of mixing these mediums on the same controller, the driver will handle up to 
four controllers. 

The driver reads the disk hardware drive-type register to determine access partitioning and other drive 
dependent attributes. Thus, the manual entries describing the above disk drives should be used for informa¬ 
tion regarding that particular drive. 

The configuration name of disk should be specified when generating a system with config(IM). 

PILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

config(lM), master(4), hm(7), hp(7), rm80(7), rp(7). 
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NAME 

gt - general driver for tape drives 

DESCRIPTION 

Gt provides a general interface to the TE16 and TU8 tape drives. In addition to the capability of mixing 
these mediums on the same controller, the driver will handle up to two controllers. 

The driver reads the tape hardware drive-type register to determine drive dependent attributes. Thus, the 
manual entries describing the above tape drives should be used for information regarding that particular 
drive. 

The configuration name of tul678 should be specified when generating a system with config{lM). 

EILES 

/dev/mt*, /dev/rmt* 

SEE ALSO 

config(lM), master(4), ht(7), tu78(7). 
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NAME 

hm - RM05 moving-head disk 

DESCRIPTION 

The files rpO, rp7 refer to sections of the RM05 disk drive 0. The files rplO, rpl7 refer to drive 1, 
etc. This slicing allows the pack to be broken up into more manageable pieces. 

The origin and size of the sections on each drive are as follows: 

section start length 

0 0 24320 

1 40 476064 

2 160 403104 

3 280 330144 

4 400 257184 

5 520 184224 

6 640 111264 

7 0 500384 

The start address is a cylinder address, with each cylinder containing 608 blocks. It is extremely unwise for 
all of these files to be present in one installation, since there is overlap in addresses and protection becomes 
a sticky matter. 

The rp files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rrp and end with a number which selects the same disk section as the 
corresponding rp file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

PILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

gd(7), hp(7), rm80(7), rp07(7). 
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NAME 

hp - RP04/RP05/RP06 moving-head disk 

DESCRIPTION 

The files rpO,rp7 refer to sections of the RP04/RP05/RP06 disk drive 0. The files rplO, rpl7 refer to 
drive 1, etc. This slicing allows Ihe pack to be broken up into more manageable pieces. 

The origin and size of the sections on each drive are as follows: 



RP04/05 


section 

start 

length 

0 

0 

18392 

1 

44 

153406 

2 

201 

87780 

3 

358 

22154 

4 

- 

- 

5 

- 

- 

6 

- 

- 

7 

0 

171798 


RP06 


section 

start 

length 

0 

0 

18392 

1 

44 

322278 

2 

201 

256652 

3 

358 

191026 

4 

515 

125400 

5 

672 

59774 

6 

- 

- 

7 

0 

340670 


The start address is a cylinder address, with each cylinder containing 418 blocks. It is extremely unwise for 
all of these files to be present in one installation, since there is overlap in addresses and protection becomes 
a sticky matter. 

The rp files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rrp and end with a number which selects the same disk section as the 
corresponding rp file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

PILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

gd(7), hm(7), hp(7), rm80(7), rp07(7). 
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NAME 

hs - RHl 1/RJS03-RJS04 fixed-head disk hie 

DESCRIPTION 

The hies hsO, hs7 refer to RJS03 disk drives 0 through 7. The hies hs8, hslS refer to RJS04 disk 
drives 0 through 7. The RJS03 drives are each 1024 blocks long and the RJS04 drives are 2048 blocks long. 

The hs hies access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw HS hies begin with rhs. The same minor device considerations hold for the raw interface 
as for the normal interface. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

PILES 

/dev/hs*, /dev/rhs* 


Page 1 



HT(7) 


(DEC only) 


HT(7) 


NAME 

ht - TU16/TE16 magnetic tape interface 

DESCRIPTION 

The files mtO, mtlS refer to the Digital Equipment Corporation TU16 magnetic tape control and trans¬ 
ports. The files mtO, mt7 are SOObpi, and the files mtS, mtlS are 1600bpi. The files mtO, mt3, 
mtS, mill are designated normal-rewind on close, and the files mt4, mt7, mtl2, mtlS are no¬ 
rewind on close. When opened for reading or writing, the tape is assumed to be positioned as desired. 
When a file is closed, a double end-of-file (double tape mark) is written if the file was opened for writing. 
If the file was normal-rewind, the tape is rewound. If it is no-rewind and the file was open for writing, the 
tape is positioned before the second EOF just written. If the file was no-rewind and opened read-only, the 
tape is positioned after the EOF following the data just read. Once opened, reading is restricted to between 
the position when opened and the next EOF or the last write. The EOF is returned as a zero-length read. By 
judiciously choosing mt files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512 byte records terminated by an EOF. To the extent possible, the sys¬ 
tem makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual meaning and 
it is possible to read or write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ¬ 
ten, the “raw” interface is appropriate. The associated files are named rmtO, ..., rmtlS. Each read or 
write call reads or writes the next record on the tape. In the write case the record has the same length as the 
buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. An EOF is returned as a zero-length read, with the tape positioned after the EOF, so that the 
next read will return the next record. 

EILES 

/dev/mt*, /dev/rmt* 

BUGS 

If any non-data error is encountered, it refuses to do anything more until closed. The driver is limited to 
four transports. 

SEE ALSO 

gt(7), tu78(7). 
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NAME 

kl - KL-11 or DL-11 asynchronous interface 

DESCRIPTION 

The discussion of typewriter I/O given in tty{l) applies to these devices. 

Since they run at a constant speed, attempts to change the speed are ignored. 
The on-line console typewriter is normally interfaced using a KL-11 or DL-11. 

PILES 

/dev/console 

SEE ALSO 

init(lM), tty(7). 

BUGS 

Modem control for the DL-1 IE is not implemented. 
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NAME 

kmc - KMC-11B/KMS11 microprocessor 

DESCRIPTION 

The files kmc? are used to manipulate the KMCll-B or KMSll microprocessor. The device handler pro¬ 
vides the basic mechanism needed to load, run, and debug programs on the microprocessor. The open is 
exclusive; at most one open at a time. 

Addresses 0-8195 reference the 4096 words of instructions in the control memory of the microprocessor. 
This portion is word oriented, that is, the address and byte count must be even. 

Addresses 8196-12211 reference the 4096 bytes of data in the data memory of the microprocessor. The 
data portion may be read or written with no restrictions on addressing. 

The ioctl(2) function is used to provide access to the basic microprocessor capabilities. 

#include <sys/kmc.h> 
ioctl (hides, command, arg) 
struct kmcntl { 

int kmd; 

short *kcsr; 

int kval; 

} *arg; 

The only command available is KCSETA. The pointer kcsr contains the address of a 4 word buffer for the 
UNIBUS Control and Status Registers associated with the microprocessor. The value of kmd determines the 
function: 

1 single step and return CSRs in kcsr. 

2 maintenance step: execute value and then return CSRs. 

3 return CSRs. 

4 stop: clear the run bit. 

5 reset: set then clear the master clear bit. 

6 run: set the run bit and set the software state to kval and running. 

7 line unit maintenance: set the line unit bits from kval. 

8 set CSR sel6 to kval. 

9 clear: hrst reset, then empty the input queue. 

EILES 

/dev/kmc? 

SEE ALSO 

kasb(l), dz(7), vpm(7). 
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NAME 

Ip - line printer 
DESCRIPTION 

Lp provides the interface to any of the standard Digital Equipment Corporation LP-11 UNIBUS line printers. 
When it is opened or closed, a suitable number of page ejects is generated. Bytes written are printed. 

An internal parameter within the driver determines whether or not the device is treated as having a 96- or 
64-character set. In half-ASCII mode, lower case letters are turned into upper case and certain characters 
are escaped according to the following table: 

{ 4 

} 4 


The driver correctly interprets carriage returns, backspaces, tabs, and form-feeds. A new-line that extends 
over the end of a page is turned into a form-feed. The default line length is 132 characters, indent is 4 char¬ 
acters and lines per page is 66. Lines longer than the line length minus the indent (i.e. 128 characters, using 
the above defaults) are truncated. 

Two ioctl(2) system calls are available: 

#include <sys/lprio h> 
ioctl (hides, command, arg) 
struct Iprio *arg; 

The commands are: 

LPRGET Get the current indent, columns per line, and lines per page and store in the Iprio struc¬ 
ture referenced by arg. 

LPRSET Set the current indent, columns per line, and lines per page from the structure referenced 
by arg. 

Thus, indent, page width and page length can be set with an external program. 

EILES 

/dev/lp 

SEE ALSO 

Ipr(l). 
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NAME 

mem, kmem - core memory 

DESCRIPTION 

Mem is a special file that is an image of the core memory of the computer. It may be used, for example, to 
examine, and even to patch the system. 

Byte addresses in mem are interpreted as memory addresses. References to non-existent locations cause 
errors to be returned. 

Examining and patching device registers is likely to lead to unexpected results when read-only or write- 
only bits are present. 

The file kmem is the same as mem except that kernel virtual memory rather than physical memory is 
accessed. 

On the PDP-11, the I/O page begins at location 0160000 of kmem and per-process data for the current pro¬ 
cess begins at 0140000. 

EILES 

/dev/mem, /dev/kmem 

BUGS 

On the PDP-11, memory files are accessed one byte at a time, an inappropriate method for some device reg¬ 
isters. 
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NAME 

mil 1 - MLl 1 solid-state disk 

DESCRIPTION 

The MLl 1 is a solid state disk manufactured by Digital Equipment Corporation. It has a capacity of one to 
four megabytes and a transfer rate of 0.25 to 2.00 megabytes per second. It is supported as part of the gen¬ 
eral disk driver (see gdil)). The device is not usable as either a boot device or an initial load device. It is 
intended for use on the PDP-11 line for faster /dev/swap, /bin or /Imp operations. 

EILES 

/dev/rp*, /dev/rrp*, /dev/swap 
SEE ALSO 

gd(7), hm(7), hp(7), rp(7), rp07(7), rm80(7). 
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NAME 

nc - network control 

DESCRIPTION 

The network control pseudo-device provides a means by which a privileged user process can install, 
remove, and get the status of a BX.25 Permanent Virtual Circuit (PVC), and attach, detach, start, stop, get 
the status of, and perform a changeover on a BX.25 link. Additional functions are planned for this driver 
when the virtual-call feature and additional layers of BX.25 are added to the UNIX System BX.25 
implementation. The BX.25 driver supports open{2), close(2), and ioctl(2) system calls. Definitions of 
constants and declarations for the data structures mentioned can be obtained by: 

#include <sys/nc.h> 

The network-control ioctl system call has the following form: 
ioctl (hides, cmd, arg) 

where fildes is the hie descriptor returned by the open of the nc device and cmd is one of the following con¬ 
stants: 

NCPVCI - Install a PVC. This command creates one end of a PVC by connecting a minor device of the 
BX.25 driver (slot) to a particular logical channel on a specihed link. Arg is a pointer to a ncpvc data struc¬ 
ture where slot is the minor device number of the slot to be used as the end point of the PVC, chno is the 
logical channel number to be used, and link is the number of the BX.25 link to be used. Links are num¬ 
bered starting with 0. Chno must be in the range 1 to 4,095 and must not be currently in use on this link. 
The following errors may be returned: ENXIO if the minor device number is out of range; ECHRNG if the 
channel number is out of range; ELNRNG if the link number is out of range; EBUSY if the slot is in use. The 
two low-order bits of options specify one of three possible session-establishment protocols: 

PVC SESS session-layer open/close protocol 

PVC RST reset in-order/out-of-order protocol 

PVC NONE “no-protocol” session mode 

These protocols are explained in x25(7). The constants PVC SESS, PVC RST, and PVC NONE are defined 
in /usr/include/sys/x25u.h. If the link on which the PVC is installed is currently active (i.e., not in the 
halted state), the BX.25 reset procedure will be initiated for the logical channel. When the reset procedure 
is completed, the PVC is ready for data transfer. 

NCPVCR - Remove a PVC. If arg is the minor device number of a slot that is currently associated with a 
PVC and is not open, the local end of that PVC is removed, i.e., disconnected. The slot and logical channel 
number become available for reuse. The following errors may be returned: ENXIO if the minor device 
number is out of range; ENODEV if the minor device is not installed; EBUSY if the slot is in use. 

NCPVCSTAT - Get the status of a PVC. This command gets the connection and status information for slot 
slot and places it in the ncpvcstat data structure pointed to by arg. The following errors may be returned: 
ENXIO if the minor device number is out of range; ENODEV if the minor device is not installed. 

NCATTACH, NCBKATTACH - Associate a link with a specified communications device and mark the 
device as primary (NCATTACH) or backup (NCBKATTACH). Arg is a pointer to an ncattch data structure 
that contains the link number and major/minor device number of the device. The following errors may be 
returned: ELNRNG if the link number is out of range; EACCES if the link is already attached; EBUSY if the 
device is already attached; ENOCSI if no CSI structure is available; ENXIO if the minor device number of 
the communications device is out of range. 

NCDETACH, NCBKDETACH - Disassociate the link specified by arg from its associated primary 
(NCDETACH) or backup (NCBKDETACH) device. The link and device become available for reuse. The 
following errors may be returned: ELNRNG if the link number is out of range; EUNATCH if the link is not 
attached to a device; ENODEV if the device is not attached; EBUSY if the device has not been halted. 

NCSTART, NCBKSTART - Start a specified link. The level 2 protocol is started on the primary 
(NCSTART) or backup (NCBKSTART) device associated with the link specified. Arg is a pointer to an 
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ncstart data structure that contains information such as the link number and packet size. The level 3 restart 
procedure is then initiated for the link if NCSTART is the command used. The following errors may be 
returned: ELNRNG if the link number is out of range; EUNATCH if the link is not attached to a device; 
EBUSY if the device is already started; EINVAL if the packet size specified with NCSTART is different from 
that specified with NCBKSTART. 

NCSTOP, NCBKSTOP - Stop a BX.25 link. The NCSTOP command stops the level 3 protocol on the link 
specified by arg and the link data structure is reinitialized. For either command, the level 2 protocol is 
stopped on the associated primary or backup device. For NCSTOP, if a backup device has been attached, 
the level 2 protocol is also stopped on that device. The following errors may be returned: ELNRNG if the 
link number is out of range; EUNATCH if the link is not attached to a device; EBUSY if the level 3 protocol 
is running on the backup device (NCSTOP). 

NCCHNGE - Changeover to the standby device associated with the link specified by arg. If the standby 
device is synchronized at level 2, the level 3 protocol will now run on that device. The following errors 
may be returned: ELNRNG if the link number is out of range; EUNATCH if the link is not attached to both a 
primary and backup device; EACCES if the backup device was not started. 

NCLNKSTAT - Get the status of a link. This command gets the connections and status information for link 
link and places it in the nclnkstat data structure pointed to by arg. The following errors may be returned: 
ELNRNG if the link number is out of range; EUNATCH if the link is not attached to either a primary or 
backup device. 

SEE ALSO 

x25pvc(lM), x25(7). 
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NAME 

nsc - NSC adapter interface specification 

DESCRIPTION 

The special files nscO,nscn refer to the control of a Network Systems Corporation (NSC) A-410 proces¬ 
sor adapter. Each special file multiplexes across the transmission medium the full-duplex network opera¬ 
tions of twenty (20) simultaneous opens. 

Physical NSC network transmissions occur in two parts and in the following order: a 64-byte message 
block and an n-byte associated data block. The 64-byte message contains network control and routing 
information. The network message has the following structure: 

struct nmsg 

{ 

char nm_adata; /* associated data hag */ 
char nm_trunk; /* trunk selection */ 
char nm_acode; /* access code */ 
char nm_vchan; /* virtual channel */ 
short nm_tonad; /* "to" network address */ 
short nm_frnad; /* "from" network address */ 
char nm_fnc; /* protocol function */ 
char nm_opcod; /* adapter operation code */ 
char nm_data[54]; /* control info */ 

}; 


The associated data block transfers large, variable-length data blocks. The NSC driver currently limits the 
associated data block size to 4096 bytes. 

The driver issues the proper function code sequences to the A-410 adapter. The available function codes 
are defined as follows: 

ATM 0005 /* Transmit Message */ 

ATD 0010 /* Transmit Data */ 

ATLSTD 0014 /* Transmit Last Data */ 

ATLM 0021 /* Transmit Local Message */ 

AIM 0045 /* Input Message */ 

AID 0050 /* Input Data */ 

ASTAT 0101 /* Status */ 

AMDPO 0140 /* Mark Down Port 0 */ 

AMDPl 0144 /* Mark Down Port 1 */ 

AMDP2 0150 /* Mark Down Port 2 */ 

AMDP3 0154 /* Mark Down Port 3 */ 

AMDRO 0160 /* Mark Down Port 0 & Reroute Msgs */ 

AMDRl 0164 /* Mark Down Port 1 & Reroute Msgs */ 

AMDR2 0170 /* Mark Down Port 2 & Reroute Msgs */ 

AMDR3 0174 /* Mark Down Port 3 & Reroute Msgs */ 

ARST 0241 /* Read Statistics */ 

ARCST 0245 /* Read & Clear Statistics */ 

ASTST 0300 /* Set Test */ 

ASAL 0305 /* Set Address & Length */ 

AWA 0310 /* Write Adapter */ 

ARA 0314 /* Read Adapter */ 

AC A 0340 /* Clear Adapter */ 

AEOP 0344 /* End Operation */ 

ACLWM 0346 /* Clear Wait Lor Message State */ 

AWAITM 0350 /* Wait Message */ 
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The driver always saves the network status bytes on failed or aborted transfer attempts. The user may 
retrieve the eight bytes of adapter status and perform the appropriate error recovery procedures. The eight 
adapter status bytes are defined by the following structure: 

struct adptrst 


char st_afc; 
char st_gsw; 
char st_trkst; 
char st_trkrsp; 
char st_err; 
char st_intemal; 
char st_rtnrsp; 
char st_spare[3]; 


/* last function code */ 

/* general status word */ 

/* trunk status */ 

/* trunk response */ 

/* adapter error code */ 

/* reserved for adapter use */ 
/* remote returned response */ 


After successful open(2) completion and before reading and writing to the network, the user must establish 
a virtual channel. Both the local and the remote machines must agree on this virtual channel to properly 
transfer data. A virtual channel is defined to be a destination network address and a virtual channel number. 
The driver enforces mutually exclusive virtual channels to properly route incoming network transmissions. 
There are currently 256 virtual channel numbers (0-255) supported. If the user specifies a zero destination 
address in the virtual channel, that process will receive the incoming transmissions from all remote nodes 
on the specified virtual channel number. If, however, another process establishes a virtual connection with 
the same virtual channel number but with a specific (non-zero) destination address, the specific connection 
will preempt the non-specific (zero destination address) connection and receive all incoming message trans¬ 
missions from the particular remote node. 

The NSC driver supports two modes of transfer: data and control. Data mode is the default mode. After 
virtual channel configuration, the user process performs simple reads and writes. The process does not need 
to know that it is transmitting across the NSC bus. Placement of the data into the message, the associated 
data block, or both is completely transparent. The user may optionally specify, however, that the first n- 
bytes of the transfer buffer be always placed into the NSC message (0 <= n <= 52). This may be particu¬ 
larly useful when transferring combinations of binary (i.e protocol headers) and character data (i.e. files) 
between heterogeneous machines (see the NSCIOASMB NSC ioctl(2) command). Reads and writes in data 
mode return the total number of user bytes transferred. 

In control mode, the user has direct access to the NSC control information within the NSC message. The 
user process specifies to the driver two pointers to static buffer areas, one for reads and one for writes. For 
write operations, the user builds a modified version of the NSC message in the write static buffer area. 
When the write {2) system call is made, the driver retrieves the data from this buffer to build the outgoing 
NSC message. The structure for the write static buffer area is: 


struct nsctrl { 

short cn_flags; 
short cn tonad; 
char cn_fnc; 
char cn_opcode; 
char cn_data[54]; 


/* associated data flag */ 

/* destination address */ 

/* adapter function code */ 
/* adapter operation code */ 
/* unused data area */ 


If the user sets the associated data flag in cn_flags (NSCADATA), the buffer pointer in the write {2) call is 
sent in the associated data block. Otherwise, the driver transfers a message alone. 

On control mode read operations, the driver places the entire 64-byte NSC message into the read static 
buffer area. If the message has an associated data block, the received data is placed into the buffer area 
specified in the read{2) system call. 
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For both control mode reads and writes, the NSC driver returns the number of bytes transferred in the asso¬ 
ciated data block. The driver returns a count of one (1) if a message alone was transmitted or received. 

User processes configure parameters into the driver through ioctl(2). The driver recognizes the following 
ioctl requests: 

NSCIODATA (struct datam *) argp 

NSCIODATA places the virtual connection into data mode (the default mode for successful opens). 
The user specifies the number of data bytes always contained in the NSC message on reads and 
writes. Argp is a pointer to the following structure: 

struct datam { 

short i_mbytes; /* bytes in msg on reads */ 
short o_mbytes; /* bytes in msg on write */ 

}; 

NSCIOCTRL (struct ctrlm *) argp 

NSCIOCTRL places the virtual connection into control mode. Argp is a pointer to the following 
structure: 


struct ctrlm { 

struct nmsg *i_mptr; /* read static area */ 
struct nsctrl *o_mptr; /* write static area */ 

}; 

NSCIOVCHAN (struct nscvchan *) argp 

NSCIOVCHAN configures the virtual channel for the specified open. Argp is a pointer to the follow¬ 
ing structure: 


struct nscvchan { 

short v_tonad; 
char v_vchan; 
char v_tmsk; 
char v_acode; 

}; 


/* destination network addr */ 
/* virtual channel number */ 
/* trunk mask */ 

/* access code */ 


V_tonad and v_ychan configure the virtual channel for all subsequent reads and writes to the network. 
V_tmsk sets the trunk transfer mask for network transfers. For trunk transfers, each bit in the trunk 
mask is cleared in the trunk specification of the NSC network message (nmjrunk). V_acode is the 
hardware access code place into the outgoing NSC network message (nm_acode). 

NSCIOESTAT (struct adptrst *) argp 

NSCIOESTAT retrieves into the user buffer specified by argp the 8 bytes of adapter status from the 
last failed network operation. After the status bytes are retrieved, the buffer area in the driver is 
cleared. 

NSCIOGETP (struct nscgetty *) argp 

NSCIOGETP retrieves network connection parameters from the driver. Argp is a pointer to the fol¬ 
lowing structure: 


struct nscgetty { 


short g flags; 

/* 

char g openm; 

/* 

char g vchan; 

/* 

short g taddr; 

/* 

char g acode; 

/* 

char g tmsk; 

/* 


connection flags */ 
file open mode */ 
virtual channel number */ 
destination network addr */ 
access code */ 
trunk mask */ 
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struct nscasmb g_asm; /* assembly modes */ 

}; 

NSCIOASMB (struct nscasmb *) argp 

NSCIOASMB selects the assembly/disassembly modes for network message and associated data block 
transmission and reception. Assembly modes are not necessary unless data is transferred between 
heterogeneous processors. Assembly mode 0 causes the hardware to swap incoming and outgoing 
bytes. This one is used primarily when transferring character data. Assembly mode 1 causes no 
swapping. This one is used primarily when transferring binary data. Assembly mode 1 is defaulted 
for the NSC message; assembly mode 0 is defaulted for the associated data block. Argp is a pointer to 
the following structure: 

struct nscasmb { 

unsigned i_msg : 2; /* input msg */ 

unsigned i_data : 2; /* input data */ 

unsigned o_msg : 2; /* output msg */ 

unsigned o_data : 2; /* output data */ 

}; 

NSCIOADDR (short *) argp 

NSCIOADDR returns to the calling process the network address of the local node. The local address 
is generated from data retrieved from the adapter. 

NSCIOBYE (char *) 0 

NSCIOBYE disconnects the user process from the driver. This function performs the necessary 
cleanup to ensure proper driver operation. 

NSCIOFCODE (struct nscfcode *) argp 

NSCIOECODE allows the user to issue any function to the adapter. The super-user is allowed to issue 
any function; others may issue only the status function (ASTAT). Argp is a pointer to the following 
structure: 

struct nscfcode { 

char *f_base; /* buffer area */ 
short f_cnt; /* no. of bytes to xfer */ 
short f_fcode; /* func. code to issue */ 

}; 

NSCIOCANCEL (char *) 0 

NSCIOCANCEL is a super-user only function. This command cancels the currently active adapter 
operation and returns an error to the effected user process. This command is used to clear hung pro¬ 
cesses. 

NSCIOOEFLINE (char *) 0 

NSCIOOFFLINE is a super-user only function. This command inhibits via software all function code 
issuance. Opens will occur normally, but all reads and writes will block. There is one exception: the 
super-user (by an NSCIOFCODE command) may issue any function. 

NSCIOONLINE (char *) 0 

NSCIOONLINE is a super-user only function. This command enables via software all function code 
issuance. This command is the converse of NSCIOOFFLINE. 

FILES 

/usr/src/cmd/nusend/nscdef.h 
/usr/include/sys/nsc h 

SEE ALSO 

nusend(IC), ioctl(2), read(2), write(2). 
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DIAGNOSTICS 

Read(2) and write(2) both return the number of bytes successfully transferred. A -1 is returned on error. 

BUGS 

An error return does not necessarily mean that the network is down. Whenever an error occurs, adapter sta¬ 
tus should be retrieved from the driver. Most failed operations should be retried several times before giving 
up. 

In control mode, 1 is returned if a message alone is transmitted or received. 
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NAME 

null - the null file 
DESCRIPTION 

Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes. 

EILES 

/dev/null 
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NAME 

osm - interface to UNIX System messages 

DESCRIPTION 

Operating system messages are stored in a circular buffer in the system and can be read or written using the 
special files /dev/osm*. A read from the file /dev/osm* will return some portion of the data in the circular 
buffer. A write to the file /dev/osm* will add the user data to the current end of the circular buffer. Any 
number of users can use the osm interface at once. 

In particular; Reads from the file /dev/osm start at the current end of the circular buffer and wait for new 
data to be added. Reads from the file /dev/osm.cur start at the begining of the circular buffer and return 
zero bytes when the current end of the circular buffer is reached. Reads from the file /dev/osm.all start at 
the begining of the circular buffer, go to the current end of the circular buffer, and then wait for new data to 
be added. 

The easiest way to use the osm interface is by typing: 
cat -u /dev/osm & 


or by typing: 


echo message > /dev/osm 


EILES 

/dev/osm* 
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NAME 

pci - parallel communications link interface 

DESCRIPTION 

Pci provides the interface for up to two Digital Equipment Corporation PCL-llB network buses. Each bus 
can be used to interconnect up to 16 CPU’s, providing relatively fast communication without individual 
point-to-point connections. 

The interface permits simultaneous bi-directional communication between any machines on a single bus. 
Additionally, each such path is further subdivided into 8 independent channels. A single control interface 
is provided to reduce the line monitoring overhead for a daemon process. 

The minor device number for a PCL channel is constructed as follows: 

the low order 3 bits specify a channel number. 

the next 4 bits specify one of 16 machines. (This number must be one less than the PCL Time Divi¬ 
sion Multiplexed bus number set in the hardware.) 

the next bit specifies one of 2 PCL’s. 

Note that if the remote end issues a close (or an open after a crash), the channel must be closed and re¬ 
opened to reset its state. Such a condition can be detected by the error EBADF returned by a read, write or 
ioctl. 

There is a per-channel control interface supported via ioctl(2) calls: 

include <sys/pcl h> 

ioctl(fildes, command, arg) 

struct ctrlmsg { char * addr; int count; } arg; 

The commands using this form are: 

CTRL Send a control message. Get the message specified in arg and send it to the control port for 
this channel at the remote end. 

GET Extract details from the pci structure for this channel. Of particular interest is the value of 
pcljlag which will give an indication of the status of the channel. Either the whole, or a 
part, of the pci structure may be read out. 

GDEBUG 

Extract details from the pcldb circular buffer containing debug info. The value returned by 
the call is an index to the next empty slot. 

Additional ioctl (2) calls have the form: 

ioctl(fildes, command, arg) 
int arg; 

The commands using this form are: 

WAIT Wait for a remote open or close. If a remote close is detected, this call returns EBADF. Note 
that if the remote channel is already open, this call returns immediately. 

FLAG Change the values of the pcljlag bits P RETRY (allow retries on errors) and P NOCTRL 
(force error return from any subsequent ioctl calls) to those in arg. 

SIG Send the signal specified in arg to the remote end. 

RSTR Turn on the pci Jag bit PRSTR which prevents use of the CTRL call above. 

FILES 

/dev/pcl/*[0-7] normal machine and subchannel interface. 

/dev/pcl/ctrl control interface. 
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SEE ALSO 

net(lC), pcldaemon(lC), ioctl(2). 
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NAME 

prf - operating system profiler 

DESCRIPTION 

The file prf provides access to activity information in the operating system. Writing the file loads the mea¬ 
surement facility with text addresses to be monitored. Reading the file returns these addresses and a set of 
counters indicative of activity between adjacent text addresses. 

The recording mechanism is driven by the system clock and samples the program counter at line frequency. 
Samples that catch the operating system are matched against the stored text addresses and increment corre¬ 
sponding counters for later processing. 

The file prf is a pseudo-device with no associated hardware. 

PILES 

/dev/prf 
SEE ALSO 

config(lM), profiler(lM). 
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NAME 

rf - RFll/RSll fixed-head disk hie 

DESCRIPTION 

This hie refers to the concatenation of all RS-11 disks. 

Each disk contains 1024 256-word blocks. The length of the combined RF hie is 1024x(minorH-l) blocks. 
That is minor device zero is taken to be 1024 blocks long; minor device one is 2048, etc. 

The rfO hie accesses the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
FO operation and therefore raw VO is considerably more efficient when many words are transmitted. The 
name of the raw RF hie is rrfO. The same minor device considerations hold for the raw interface as for the 
normal interface. 

In raw VO the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

FILES 

/dev/rfO, /dev/rrfO 

BUGS 

The 512-byte restrictions on the raw device are not physically necessary, but are still imposed. 
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NAME 

rk - RK-11/RK03 or RK05 disk 

DESCRIPTION 

The file rk? refers to an entire RK03 disk as a single sequentially-addressed file. Its 256-word blocks are 
numbered 0 to 4871. 

The rk files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RK files begin with rrk and end with a number which selects the same disk as the corre¬ 
sponding rk file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

PILES 

/dev/rk*, /dev/rrk* 
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NAME 

rl-RL-ll/RLOl disk 

DESCRIPTION 

rlO,rl3 refer to an entire RLOl disk drive as a single sequentially-addressed file. Its 256-word blocks are 
numbered 0 to 10239. 

The rl files access the disk via the system’s normal buffering mechanism and may be read and written with¬ 
out regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmission 
between the disk and the user’s read or write buffer. A single read or write call results in exactly one I/O 
call and therefore raw I/O is considerably more efficient when many words are transmitted. The names of 
the raw RL files begin with rrl and end with a number which selects the same disk as the corresponding rl 
file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

EILES 

/dev/rl*, /dev/rrl* 
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NAME 

rm80 - RM80 moving-head disk 

DESCRIPTION 

The files rpO, rp7 refer to sections of the RM80 disk drive 0. The files rplO, rpl7 refer to drive 1, 
etc. This slicing allows the pack to be broken up into more manageable pieces. 

The origin and size of the sections on each drive are as follows: 

section start length 

0 0 18228 

1 42 224378 

2 194 158410 

3 346 92442 

4 498 26474 

5 - - 

6 - - 

7 0 242606 

The start address is a cylinder address, with each cylinder containing 434 blocks. It is extremely unwise for 
all of these files to be present in one installation, since there is overlap in addresses and protection becomes 
a sticky matter. 

The rp files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RM files begin with rrp and end with a number which selects the same disk section as the 
corresponding rp file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

EILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

gd(7), hm(7), hp(7), rp(7), rp07(7). 
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NAME 

rp - RP-11/RP03 moving-head disk 

DESCRIPTION 

The files rpO,rp7 refer to sections of the RP03 disk drive 0. The files rplO,rpl7 refer to drive 1, etc. 
This slicing allows the pack to be broken up into more manageable pieces. 

The origin and size of the sections on each drive are as follows: 

section start length 

0 0 10000 

1 50 71200 

2 203 40600 

3 - - 

4 - - 

5 - - 

6 - - 

7 0 81200 

The start address is a cylinder address, with each cylinder containing 200 blocks. It is extremely unwise for 
all of these files to be present in one installation, since there is overlap in addresses and protection becomes 
a sticky matter. 

The rp files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rrp and end with a number which selects the same disk section as the 
corresponding rp file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

PILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

hp(7). 
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NAME 

rp07 - RP07 non-removable medium moving-head disk 

DESCRIPTION 

The files rpO, rp7 refer to sections of the RP07 disk drive 0. The files rplO, rpl7 refer to drive 1, 
etc. This slicing allows the pack to be broken up into more manageable pieces. 

The origin and size of the sections on each drive are as follows: 

section start length 
0 0 64000 

1 40 944000 

2 105 840000 

3 210 672000 

4 315 504000 

5 420 336000 

6 525 168000 

7 0 1008000 

The start address is a cylinder address, with each cylinder containing 1600 blocks. It is extremely unwise 
for all of these files to be present in one installation, since there is overlap in addresses and protection 
becomes a sticky matter. 

The rp files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rrp and end with a number which selects the same disk section as the 
corresponding rp file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise lseek{2) calls should specify a multiple of 512 bytes. 

PILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

gd(7), hm(7), hp(7), rp(7), rm80(7). 
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NAME 

St - synchronous terminal interface 

DESCRIPTION 

The synchronous terminal interface is a pseudo-device driver that enables a UNIX System to communicate 
with TELETYPE.nh Model 4540 compatible ASCII synchronous terminals. The driver utilizes the bottom 
half of the Virtual Protocol Machine (VPM) to perform the end-to-end protocol and transmission assurance 
for the synchronous line. 

There are two modes of operation for synchronous terminals; application mode and line mode. In applica¬ 
tion mode, the user must be familiar with the operation of the Model 4540 terminal. Screen management 
functions are completely controlled by the user process; when formating a screen, the user must supply 
everything from the initial STX (Start-of-Text) character to the ETX (End-of-Text) character. 

In line mode, the basic screen management functions are handled by the driver to make the synchronous 
terminal usable as a login terminal for most of the standard UNIX System commands. (Commands that put 
the terminal in raw mode or write any control characters to the screen will probably not work as expected.) 
Writes to the terminal will be packaged in the necessary protocol so that only terminal operator input will 
be returned to the user process on a read{2). See sffy(l) for details on setting these modes and other avail¬ 
able options. 

By convention, /dev/st? is the synchronous terminal control channel for communications line ?. Communi¬ 
cation with the control channel is handled by the stcntrl and stprint commands (see sf(lM)). 

A user process will sleep when trying to open a terminal channel, until a terminal requests service. At that 
time, a channel will be assigned to that terminal, and it will remain allocated until the user process closes 
the terminal. 


A user process will not sleep when trying to open a printer channel. Printer channel connections are estab¬ 
lished by stprint and remain in effect until the associated communications line drops. 

In addition to the synchronous terminal equipment, appropriate synchronous VPM hardware is required. 


EILES 

/lib/stscr 

/dev/un53.? 

/dev/kmc? 

/dev/vpb? 

/dev/st? 

/dev/tty* 

/dev/sp* 


synchronous terminal prototype script 
TN82/UN53 peripheral controller pair (3B20S only) 
KMCll-B microprocessor (DEC only) 

VPM bottom half (DEC only) 
synchronous terminal control channels 
synchronous terminal user channels 
synchronous printer user channels 


In addition to the standard ioctl functions listed in stermio{l), the commands defined in 
/usr/include/sys/stermio.h are provided with the following interfaces: 


ioctl(stcontrolfd, STPRINT, device) 
char device; 


tells the driver that a printer is at the device address specified by device on the synchronous communica¬ 
tions line associated with stcontrolfd. The return value is the minor device number associated with the 
printer. A -1 is returned if the association can’t be made. (Too many printers are already associated or the 
communications line is not connected.) 

ioctl(stcontrolfd, VPMSDEV, arg); 

will assign VPM minor device number arg to the line associated with stcontrolfd. 
ioctl(stcontrolfd, STSTART); 

tells the driver to start up the line associated with stcontrolfd. If this is the first line started, buffer space 
will be allocated from physical memory for use by all lines. 
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ioctl(stcontrolfd, STHALT); 

tells the driver to stop the line associated with stcontrolfd. If this is the last active line, the buffer space 
allocated on the first STSTART will be returned to the system. 

ioctl(stfd, STWLINE); 

returns the synchronous communications line number associated with the terminal, printer, or control chan¬ 
nel hie descriptor stfd. 

SEE ALSO 

st(lM), kmc(7), stermio(7), trace(7), un53(7), vpm(7). 
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NAME 

stermio - general synchronous terminal interface 

DESCRIPTION 

All of the synchronous communications ports use the same general interface, no matter what hardware is 
involved. The remainder of this section discusses the common features of this interface. 

When a terminal file is opened, it normally causes the process to wait until a connection is established. In 
practice, users’ programs seldom open these files; they are opened by stgetty and become a user’s standard 
input, output, and error files. The very first terminal file opened by the process group leader of a terminal 
file not already associated with a process group becomes the control terminal for that process group. The 
control terminal plays a special role in handling quit and interrupt signals, as discussed below. The control 
terminal is inherited by a child process during s.fork{2). A process can break this association by changing 
its process group using setpgrp(2). 

A terminal associated with one of these files operates in half-duplex mode. Characters may be typed only 
when the terminal is in local mode. 

When the user channel is in line mode, terminal input is processed in units of lines. A line is delimited by a 
new-line (ASCII LF) character that is supplied by the driver at the end of each field from the terminal. No 
matter how many characters are requested in the read call, at most one line will be returned. It is not, how¬ 
ever, necessary to read a whole line at once; any number of characters may be requested in a read, even one, 
without losing information. 

When the user channel is in application mode, full blocks of data from the terminal may be requested in a 
read. As in line mode, any number may be requested without losing information. The program must know 
how to interpret the protocol and field separation characters to understand the data returned. 

Certain characters have special functions on input when the user channel is in line mode. These functions 
and their default key assignments are summarized as follows: 

INTR (PAl) generates an interrupt signal which is sent to all processes with the associated control ter¬ 
minal. Normally, each such process is forced to terminate, but arrangements may be made either 
to ignore the signal or to receive a trap to an agreed-upon location; see signal{2). 

QUIT (PA2) generates a quit signal. Its treatment is identical to the interrupt signal except that, unless a 
receiving process has made other arrangements, it will not only be terminated but a core image 
file (called core) will be created in the current working directory. 

EOF (PF12) may be used to generate an end-of-file from a terminal. When received, all characters 
changed in the terminal’s buffer are queued to be passed to the program and the EOF is discarded. 
Thus, if there are no changes in the terminal’s buffer, zero characters will be passed back, which 
is the standard end-of-file indication. 

CTAB (@) will be translated to an ASCII HT character. 

SEND (S/R, PEI through PEI I) may be used to send modified fields to the program. In line mode, each 
modified field is packaged as an input line with a trailing new-line character. In application 
mode, the entire transmission block is given to the program. 

CLEAR (CLEAR) clears the screen. In line mode, the screen will be reformatted so that each line is a sep¬ 
arate field. In application mode, reformatting the screen is the program’s responsibility. 

The character value for CTAB may be changed to suit individual tastes. 

When the carrier signal from the data-set drops, a hangup signal is sent to all processes that have this termi¬ 
nal as the control terminal. Unless other arrangements have been made, this signal causes the processes to 
terminate. If the hangup signal is ignored, any subsequent read returns with an end-of-file indication. Thus 
programs that read a terminal and test for end-of-file can terminate appropriately when hung up on. 

Several ioctl{2) system calls apply to synchronous terminal files. Several of these calls use the same struc¬ 
ture defined in /usr/include/sys/termio h as described in termio{l) and accept the same TCGETA, TCSETA, 
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TCSETAW, and TCSETAF commands that are described there. When these calls are used, however, only the 
c_iflag, c_oflag, and cjflag helds are used with these helds corresponding, respectively to the imode, 
omode, and Imode helds described in the following description of the stermio structure that is dehned in 
/usr/include/sys/stermio.h. Within those helds, only the values described below, some of which overlap 
those described in termio{l), are used. 


struct stermio { 


unsigned short 
char 

ttyid; /* 
row; /* 

char 

O 

'— 

* 

char 

orow; /* 

char 

ocol; /* 

char 

tab; /* 

char 

aid; /* 

char 

Vti 

'— 

* 

char 

'— 

* 

unsigned short 
unsigned short 
unsigned short 

imode; /* 
Imode; /* 
omode; /* 


station and device id’s */ 
cursor row position at last SEND */ 
cursor col position at last SEND */ 
next output cursor row position */ 
next output cursor col position */ 
translate to tab on input */ 
function key identihcation code */ 
status and sense character 1 */ 
status and sense character 2 */ 
input modes */ 
local modes */ 
output modes */ 


The ttyid held contains the station selection character in the high order byte and the device selection charac¬ 
ter in the low order byte. 

The row and col helds contain the row and column numbers of the screen position of the cursor when the 
last SEND key was hit. Rows are numbered from 1 through 24. Columns are numbered from 1 through 80. 

The orow and ocol helds specify the next screen position that will be written. 

The tab held contains the character that will be translated to an ASCII TAB character on input if line mode 
is enabled. 


The aid held contains the function key identihcation code signifying the terminal key that caused the last 
buffer to be sent. 

The ssl and ss2 helds contain the last status and sense characters received from the terminal. 


The imode held describes the basic terminal input control: 

lUCLC 0001000 Map upper-case to lower-case on input. 

If lUCLC is set and line mode is enabled, a received upper-case alphabetic character is translated into the 
corresponding lower-case character. 

The initial input control value is all bits clear. 

The omode held specihes the system treatment of output: 


OLCUC 
TABDLY 
TABO 
TAB 3 


0000002 Map lower case to upper on output. 
0014000 Select horizontal-tab translation option: 
0 Don’t modify tabs. 

0014000 Expand tabs to spaces. 


If OLCUC is set and line mode is enabled, a lower-case alphabetic character is transmitted as the corre¬ 
sponding upper-case character. This function is often used in conjunction with lUCLC. 

Horizontal-tab type 0 specihes that tabs are not to be modihed. Type 3 specihes that tabs are to be 
expanded into spaces. 


The initial output control value is TAB3. 

The Imode held of the argument structure is used by the line discipline to control terminal functions. The 
synchronous terminal line discipline provides the following: 
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XCASE 

STFLUSH 

STWRAP 

STAPPL 


0000004 Canonical upper/lower presentation. 
0000400 Flush output on each write(2). 
0001000 Wrap around long lines. 

0002000 Use application mode. 


If XCASE is set and line mode is enabled, an upper-case letter is accepted on input by preceding it with a \ 
character, and on output is preceded by a \ character. In this mode, the following escape sequences are gen¬ 
erated on output and accepted on input: 


for: use: 

' 

I \! 

r 

{ \( 

} \) 

\ w 


For example, A is input as \a, \n as \\n, and \N as \\\n. 

If STAPPL is set, application mode is enabled. Read requests are satisfied directly from the terminal input 
buffer, and the user is responsible for handling all terminal protocol from the STX character through the 
ETX character on output. 

If STAPPL is not set, line mode processing is enabled. This enables the input fields from the terminal to be 
broken into lines terminated with a new-line chracter and the actions to provide the lUCLC, TAB3, OLCUC, 
XCASE, STELUSH, and STWRAP processing to be performed. For output, the screen is formatted so that 
each terminal line is a separate field. New-line characters cause the remainder of the current line to be 
cleared and the cursor to be positioned at the beginning of the next field. If data overflows the last line of 
the terminal, the cursor is repositioned to the beginning of the first held on the screen and output is halted 
until one of the SEND keys, the PF12 key, or the CLEAR key is hit to restart output. This allows the terminal 
operator to read a screen full of data before it is overwritten. 

The initial value for terminal modes has the STAPPL and STWRAP modes enabled. 


The primary ioctl{2) system calls using the stermio structure have the form: 

ioctl (hides, command, arg) 

struct stermio *arg; 

The commands using this form are: 

STGET Get the parameters associated with the terminal and store in the stermio structure refer¬ 
enced by arg. 

STSET Set the parameters associated with the terminal from the structure referenced by arg. 

Only the imode, Imode, ocol, omode, orow, and tab fields are affected. The change is 
immediate. A switch from application mode to line mode will cause the screen to be 
reformatted by the driver. 

EILES 

/dev/tty* 

SEE ALSO 

stty(l), ioctl(2), st(7),termio(7). 


Page 3 



TERMIO(7) 


TERMIO(7) 


NAME 

termio - general terminal interface 

DESCRIPTION 

All of the asynchronous communications ports use the same general interface, no matter what hardware is 
involved. The remainder of this section discusses the common features of this interface. 

When a terminal hie is opened, it normally causes the process to wait until a connection is established. In 
practice, users’ programs seldom open these hies; they are opened by getty and become a user’s standard 
input, output, and error hies. The very hrst terminal hie opened by the process group leader of a terminal 
hie not already associated with a process group becomes the control terminal for that process group. The 
control terminal plays a special role in handling quit and interrupt signals, as discussed below. The control 
terminal is inherited by a child process during afork{2). A process can break this association by changing 
its process group using setpgrp(2). 

A terminal associated with one of these hies ordinarily operates in full-duplex mode. Characters may be 
typed at any time, even while output is occurring, and are only lost when the system’s character input 
buffers become completely full, which is rare, or when the user has accumulated the maximum allowed 
number of input characters that have not yet been read by some program. Currently, this limit is 256 char¬ 
acters. When the input limit is reached, all the saved characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is delimited by a new-line (ASCII LF) charac¬ 
ter, an end-of-hle (ASCII EOT) character, or an end-of-line character. This means that a program attempting 
to read will be suspended until an entire line has been typed. Also, no matter how many characters are 
requested in the read call, at most one line will be returned. It is not, however, necessary to read a whole 
line at once; any number of characters may be requested in a read, even one, without losing information. 

During input, erase and kill processing is normally done. By default, the character # erases the last charac¬ 
ter typed, except that it will not erase beyond the beginning of the line. By default, the character @ kills 
(deletes) the entire input line, and optionally outputs a new-line character. Both these characters operate on 
a key-stroke basis, independently of any backspacing or tabbing that may have been done. Both the erase 
and kill characters may be entered literally by preceding them with the escape character (\). In this case the 
escape character is not read. The erase and kill characters may be changed. 

Certain characters have special functions on input. These functions and their default character values are 
summarized as follows: 

INTR (Rubout or ASCII DEL) generates an interrupt signal which is sent to all processes with the asso¬ 
ciated control terminal. Normally, each such process is forced to terminate, but arrangements 
may be made either to ignore the signal or to receive a trap to an agreed-upon location; see 
signal(2). 

QUIT (Control-1 or ASCII FS) generates a quit signal. Its treatment is identical to the interrupt signal 
except that, unless a receiving process has made other arrangements, it will not only be termi¬ 
nated but a core image hie (called core) will be created in the current working directory. 

ERASE (#) erases the preceding character. It will not erase beyond the start of a line, as delimited by a 
NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a NL, EOE, or EOL character. 

EOE (Control-d or ASCII EOT) may be used to generate an end-of-hle from a terminal. When received, 
all the characters waiting to be read are immediately passed to the program, without waiting for a 
new-line, and the EOF is discarded. Thus, if there are no characters waiting, which is to say the 
EOF occurred at the beginning of a line, zero characters will be passed back, which is the standard 
end-of-hle indication. 

NL (ASCII LF) is the normal line delimiter. It can not be changed or escaped. 

EOL (ASCII NUL) is an additional line delimiter, like NL. It is not normally used. 
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STOP (Control-s or ASCII DC3) can be used to temporarily suspend output. It is useful with CRT termi¬ 
nals to prevent output from disappearing before it can be read. While output is suspended, STOP 
characters are ignored and not read. 

START (Control-q or ASCII DCl) is used to resume output which has been suspended by a STOP charac¬ 
ter. While output is not suspended, START characters are ignored and not read. The start/stop 
characters can not be changed or escaped. 

The character values for INTR, QUIT, ERASE, KILL, EOF, and EOL may be changed to suit individual tastes. 
The ERASE, KILL, and EOF characters may be escaped by a preceding \ character, in which case no special 
function is done. 

When the carrier signal from the data-set drops, a hangup signal is sent to all processes that have this termi¬ 
nal as the control terminal. Unless other arrangements have been made, this signal causes the processes to 
terminate. If the hangup signal is ignored, any subsequent read returns with an end-of-file indication. Thus 
programs that read a terminal and test for end-of-file can terminate appropriately when hung up on. 

When one or more characters are written, they are transmitted to the terminal as soon as previously-written 
characters have finished typing. Input characters are echoed by putting them in the output queue as they 
arrive. If a process produces characters more rapidly than they can be typed, it will be suspended when its 
output queue exceeds some limit. When the queue has drained down to some threshold, the program is 
resumed. 

Several ioctl(2) system calls apply to terminal files. The primary calls use the following structure, defined 

in <termio.h>: 

#define NCC 8 

struct termio { 


unsigned 

short 

c iflag; 

/* input modes */ 

unsigned 

short 

c oflag; 

/* output modes */ 

unsigned 

short 

c cflag; 

/* control modes */ 

unsigned 

short 

c Iflag; 

/* local modes */ 

char 


c line; 

/* line discipline */ 

unsigned 

char 

c_cc[NCC]; 

/* control chars */ 


}; 

The special control characters are defined by the array c_cc. The relative positions and initial values for 
each function are as follows: 

0 INTR DEL 

1 QUIT FS 

2 ERASE # 

3 KILL @ 

4 EOF EOT 

5 EOL NUL 

6 reserved 

7 reserved 

The cjflag field describes the basic terminal input control: 

IGNBRK 0000001 Ignore break condition. 

BRKINT 0000002 Signal interrupt on break. 

IGNPAR 0000004 Ignore characters with parity errors. 

PARMRK 0000010 Mark parity errors. 

INPCK 0000020 Enable input parity check. 

ISTRIP 0000040 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore CR. 

ICRNL 0000400 Map CR to NL on input. 

lUCLC 0001000 Map upper-case to lower-case on input. 
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IXON 0002000 Enable start/stop output control. 

IXANY 0004000 Enable any character to restart output. 

IXOFF 0010000 Enable start/stop input control. 

If IGNBRK is set, the break condition (a character framing error with data all zeros) is ignored, that is, not 
put on the input queue and therefore not read by any process. Otherwise if BRKINT is set, the break condi¬ 
tion will generate an interrupt signal and flush both the input and output queues. If IGNPAR is set, charac¬ 
ters with other framing and parity errors are ignored. 

If PARMRK is set, a character with a framing or parity error which is not ignored is read as the three charac¬ 
ter sequence: 0377, 0, X, where X is the data of the character received in error. To avoid ambiguity in this 
case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. If PARMRK is not set, a framing 
or parity error which is not ignored is read as the character NUL (0). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, input parity checking is disabled. 
This allows output parity generation without input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR character. If IGNCR is set, a received CR 
character is ignored (not read). Otherwise if ICRNL is set, a received CR character is translated into a NL 
character. 

If lUCLC is set, a received upper-case alphabetic character is translated into the corresponding lower-case 
character. 

If IXON is set, start/stop output control is enabled. A received STOP character will suspend output and a 
received START character will restart output. All start/stop characters are ignored and not read. If IXANY 
is set, any input character, will restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP characters when the input queue is nearly empty/full. 

The initial input control value is all bits clear. 

The cjjflag held specifies the system treatment of output: 

OPOST 0000001 Postprocess output. 

OLCUC 0000002 Map lower case to upper on output. 

ONLCR 0000004 Map NL to CR-NL on output. 

OCRNL 0000010 Map CR to NL on output. 

ONOCR 0000020 No CR output at column 0. 

ONLRET 0000040 NL performs CR function. 

OFILL 0000100 Use All characters for delay. 

OFDEL 0000200 Fill is DEL, else NUL. 

NLDLY 0000400 Select new-line delays: 

NLO 0 

NLl 0000400 

CRDLY 0003000 Select carriage-return delays: 

CRO 0 

CRl 0001000 

CR2 0002000 

CR3 0003000 

TABDLY 0014000 Select horizontal-tab delays: 

TABO 0 

TABl 0004000 

TAB2 0010000 

TAB3 0014000 Expand tabs to spaces. 

BSDLY 0020000 Select backspace delays: 

BSO 0 

BSl 0020000 
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VTDLY 

0040000 Select vertical-tab delays: 

VTO 

0 

VTl 

0040000 

FFDLY 

0100000 Select form-feed delays: 

FFO 

0 

FFl 

0100000 


If OPOST is set, output characters are post-processed as indicated by the remaining flags, otherwise charac¬ 
ters are transmitted without change. 

If OLCUC is set, a lower-case alphabetic character is transmitted as the corresponding upper-case character. 
This function is often used in conjunction with lUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL character pair. If OCRNL is set, the CR char¬ 
acter is transmitted as the NL character. If ONOCR is set, no CR character is transmitted when at column 0 
(first position). If ONLRET is set, the NL character is assumed to do the carriage-return function; the col¬ 
umn pointer will be set to 0 and the delays specified for CR will be used. Otherwise the NL character is 
assumed to do just the line-feed function; the column pointer will remain unchanged. The column pointer 
is also set to 0 if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for mechanical or other movement when cer¬ 
tain characters are sent to the terminal. In all cases a value of 0 indicates no delay. If OFILL is set, fill char¬ 
acters will be transmitted for delay instead of a timed delay. This is useful for high baud rate terminals 
which need only a minimal delay. If OFDEL is set, the All character is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage-return delays are used instead of 
the new-line delays. If OFILL is set, two All characters will be transmitted. 

Carriage-return delay type 1 is dependent on the current column position, type 2 is about 0.10 seconds, and 
type 3 is about 0.15 seconds. If OFILL is set, delay type 1 transmits two All characters, and type 2 four All 
characters. 

Horizontal-tab delay type 1 is dependent on the current column position. Type 2 is about 0.10 seconds. 
Type 3 speciAes that tabs are to be expanded into spaces. If OFILL is set, two All characters will be trans¬ 
mitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one All character will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The c_cflag held describes the hardware control of the terminal: 


CBAUD 

0000017 

Baud rate: 

BO 

0 

Hang up 

B50 

0000001 

50 baud 

B75 

0000002 

75 baud 

BllO 

0000003 

110 baud 

B134 

0000004 

134.5 baud 

B150 

0000005 

150 baud 

B200 

0000006 

200 baud 

B300 

0000007 

300 baud 

B600 

0000010 

600 baud 

B1200 

0000011 

1200 baud 

B1800 

0000012 

1800 baud 

B2400 

0000013 

2400 baud 

B4800 

0000014 

4800 baud 

B9600 

0000015 

9600 baud 
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EXTA 

0000016 

External A 

EXTB 

0000017 

External B 

CSIZE 

0000060 

Character size: 

CSS 

0 

5 bits 

CS6 

0000020 

6 bits 

CS7 

0000040 

7 bits 

CSS 

0000060 

8 bits 

CSTOPB 

0000100 

Send two stop bits, else one. 

CREAD 

0000200 

Enable receiver. 

PARENB 

0000400 

Parity enable. 

PARODD 

0001000 

Odd parity, else even. 

HUPCL 

0002000 

Hang up on last close. 

CLOCAL 

0004000 

Local line, else dial-up. 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang up the connection. If BO is 
specified, the data-terminal-ready signal will not be asserted. Normally, this will disconnect the line. For 
any particular hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission and reception. This size does not 
include the parity bit, if any. If CSTOPB is set, two stop bits are used, otherwise one stop bit. For example, 
at 110 baud, two stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a parity bit is added to each character. If 
parity is enabled, the PARODD flag specifies odd parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will be received. 

If HUPCL is set, the line will be disconnected when the last process with the line open closes it or termi¬ 
nates. That is, the data-terminal-ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection with no modem control. Otherwise 
modem control is assumed. 


The initial hardware control value after open is B300, CSS, CREAD, HUPCL. 

The cjflag held of the argument structure is used by the line discipline to control terminal functions. The 
basic line discipline (0) provides the following: 


ISIG 

0000001 

ICANON 

0000002 

XCASE 

0000004 

ECHO 

0000010 

ECHOE 

0000020 

ECHOK 

0000040 

ECHONL 

0000100 

NOFLSH 

0000200 


Enable signals. 

Canonical input (erase and kill processing). 
Canonical upper/lower presentation. 

Enable echo. 

Echo erase character as BS-SP-BS. 

Echo NL after kill character. 

Echo NL. 

Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the special control characters INTR and QUIT. If an 
input character matches one of these control characters, the function associated with that character is per¬ 
formed. If ISIG is not set, no checking is done. Thus these special input functions are possible only if ISIG 
is set. These functions may be disabled individually by changing the value of the control character to an 
unlikely or impossible value (e.g. 0377). 


If ICANON is set, canonical processing is enabled. This enables the erase and kill edit functions, and the 
assembly of input characters into lines delimited by NL, EOE, and EOL. If ICANON is not set, read requests 
are satisfied directly from the input queue. A read will not be satisfied until at least MIN characters have 
been received or the timeout value TIME has expired. This allows fast bursts of input to be read efficiently 
while still allowing single character input. The MIN and TIME values are stored in the position for the EOF 
and EOL characters respectively. The time value represents tenths of seconds. 
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If XCASE is set, and if ICANON is set, an upper-case letter is accepted on input by preceding it with a \ 
character, and is output preceded by a \ character. In this mode, the following escape sequences are gener¬ 
ated on output and accepted on input: 

for: use: 

' 

I \! 

r 

{ \( 

} \) 

\ w 

For example, A is input as \a, \n as \\n, and \N as \\\n. 

If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If ECHO and ECHOE are set, the erase 
character is echoed as ASCII BS SP BS, which will clear the last character from a CRT screen. If ECHOE is 
set and ECHO is not set, the erase character is echoed as ASCII SP BS. If ECHOK is set, the NL character 
will be echoed after the kill character to emphasize that the line will be deleted. Note that an escape charac¬ 
ter preceding the erase or kill character removes any special function. If ECHONL is set, the NL character 
will be echoed even if ECHO is not set. This is useful for terminals set to local echo (so-called half duplex). 
Unless escaped, the EOE character is not echoed. Because EOT is the default EOE character, this prevents 
terminals that respond to EOT from hanging up. 

If NOELSH is set, the normal flush of the input and output queues associated with the quit and interrupt 
characters will not be done. 

The initial line-discipline control value is all bits clear. 

The primary ioctl(2) system calls have the form: 

ioctl (hides, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Get the parameters associated with the terminal and store in the termio structure ref¬ 
erenced by arg. 

TCSETA Set the parameters associated with the terminal from the structure referenced by arg. 
The change is immediate. 

TCSETAW Wait for the output to drain before setting the new parameters. This form should be 
used when changing parameters that will affect output. 

TCSETAE Wait for the output to drain, then flush the input queue and set the new parameters. 

Additional ioctl (2) calls have the form: 

ioctl (hides, command, arg) 
int arg; 

The commands using this form are: 

TCSBRK Wait for the output to drain. If arg is 0, then send a break (zero bits for 0.25 sec¬ 
onds). 

TCXONC Start/stop control. If arg is 0, suspend output; if 1, restart suspended output. 

TCELSH If arg is 0, flush the input queue; if 1, flush the output queue; if 2, flush both the 

input and output queues. 

EILES 

/dev/tty* 
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SEE ALSO 

stty(l), ioctl(2). 
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NAME 

tm - TMll/TUlO magnetic tape interface 

DESCRIPTION 

The files mtO, mt7 refer to the Digital Equipment Corporation TMll/TUlO magnetic tape control and 
transports at SOObpi. The files mtO, mt3 are designated normal-rewind on close, and the files mt4, 
mt7 are no-rewind on close. When opened for reading or writing, the tape is assumed to be positioned as 
desired. When a file is closed, a double end-of-file (double tape mark) is written if the file was opened for 
writing. If the file was normal-rewind, the tape is rewound. If it is no-rewind and the file was open for 
writing, the tape is positioned before the second EOF just written. If the file was no-rewind and opened 
read-only, the tape is positioned after the EOF following the data just read. Once opened, reading is 
restricted to between the position when opened and the next EOF or the last write. The EOF is returned as a 
zero-length read. By judiciously choosing mt files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512 byte records terminated by an EOF. To the extent possible, the sys¬ 
tem makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual meaning and 
it is possible to read or write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ¬ 
ten, the ‘ ‘raw’ ’ interface is appropriate. The associated files are named rmtO, ..., rmt7 Each read or write 
call reads or writes the next record on the tape. In the write case the record has the same length as the 
buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. An EOF is returned as a zero-length read, with the tape positioned after the EOF, so that the 
next read will return the next record. 

EILES 

/dev/mt?, /dev/rmt? 

BUGS 

If any non-data error is encountered, it refuses to do anything more until closed. The driver is limited to 
four transports. 
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NAME 

tn4 - eight line asynchronous interface 

DESCRIPTION 

Each of the eight lines attached to a TN4 behaves as described in termio{l). The c_cflag items of B200, 
EXTA, and EXTB are not available. 

EILES 

/dev/tty* 

SEE ALSO 

termio(7), tn74(7). 
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NAME 

tn74 - two line asynchronous interface 

DESCRIPTION 

Each of the two lines attached to a TN74 behaves as described in termio{l). The c_cflag items of B200, 
EXTA, and EXTB are not available. 

EILES 

/dev/tty* 

SEE ALSO 

termio(7), tn4(7). 
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NAME 

tn83 - console/printer interface 

DESCRIPTION 

The TN83 is a specialized controller that provides the operator interface to the 3B20S. It supports the Emer¬ 
gency Action Interface. See eai{%). 

The files /dev/console and /dev/rop refer to the system console and the receive-only printer. These special 
files implement a subset of those features described in termio{7). Among the differences are: 

Hardware options such as line speed are not selectable. The console runs at 9600 baud while the 
receive-only printer at 1200 baud. 

The ICANON option (raw mode) does not work. 

The START/STOP (control-s/control-q) characters only have a temporary affect. Use control- 
x/control-z instead. 

Data read and/or written to/from /dev/console is automatically written to the receive-only printer. The 
command line stty -echo < /dev/rop will turn off this feature while stty echo < /dev/rop will turn it on. 

System messages are normally printed to the console and the receive-only printer. These messages may be 
turned on or off by typing a control-o at the console. 

EILES 

/dev/console, /dev/rop 

SEE ALSO 

termio(7), eai(8). 
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NAME 

tn85 - medium speed line printer controller 

DESCRIPTION 

The TN85 provides a parallel interface to either one or two medium speed line printers which can operate at 
up to 2000 lines per minute (132 columns per line, 96 character ASCII set). If two printers are connected to 
a TN85, then the combined throughput cannot exceed 2000 lines per minute total. For example, it can han¬ 
dle two 1000 line per minute printers or one 2000 line per minute printer. 

EILES 

/dev/lp* 
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NAME 

trace - event-tracing driver 

DESCRIPTION 

Trace is a special file that allows event records generated within the UNIX kernel to be passed to a user pro¬ 
gram so that the activity of a driver or other system routines can be monitored for debugging purposes. 

An event record is generated from within a kernel driver or system routine by invoking the trsave function; 

trsave (dev, chno, buf, cnt) 
char dev, chno, *buf, cnt; 

Dev is a minor device number of the trace driver; chno is an integer between 0 and 15 inclusive that 
identifies the data stream (channel) to which the record belongs; buf is a buffer containing the data for an 
event; and cnt is the number of bytes in buf. Calls to trsave will result in data being placed on a queue, 
provided that some user program has opened the trace minor device dev and has enabled channel chno. 
Event records consisting of a time stamp (4 bytes), the channel number (1 byte), the count (1 byte), and the 
event data {cnt bytes) are stored on a queue until a system-defined maximum (TRQMAX) is reached; an 
event record is discarded if there is not sufficient room on the queue for the entire record. The queue is 
emptied by a user program reading the trace driver. Each read returns an integral number of event records; 
the read count must, therefore, be at least equal to cnt plus six. 

The trace driver supports open, close, read, and ioctl system calls. The ioctl system call is invoked as fol¬ 
lows: 

#include <sys/vpm.h> 
int hides, cmd, arg; 
ioctl (hides, cmd, arg); 

The values for the cmd argument are: 

VPMSETC-Enable trace channels. This command enables each channel indicated by a 1 in the bit mask 
found in arg. The low-order bit (bit 0) corresponds to channel zero, the next bit (bit 1) corre¬ 
sponds to channel 1, etc. 

VPMGETC-Get enabled channels. This command returns in arg a bit mask containing a 1 for each channel 
that is currently enabled. 

VPMCLRC-Disable channels. This command disables the channels indicated by a 1 in the bit mask found 
in arg. 

SEE ALSO 

vpmsave(lM), vpm(7). 
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NAME 

ts - TS11 magnetic tape interface 

DESCRIPTION 

The files mtO, mtl5 refer to the Digital Equipment Corporation TSll magnetic tape control and trans¬ 
ports at 1600bpi. The files mtO,mt3, mtS,mill are designated normal-rewind on close, and the files 
mt4, mt7, mtl2, mtl5 are no-rewind on close. When opened for reading or writing, the tape is 
assumed to be positioned as desired. When a file is closed, a double end-of-file (double tape mark) is writ¬ 
ten if the file was opened for writing. If the file was normal-rewind, the tape is rewound. If it is no-rewind 
and the file was open for writing, the tape is positioned before the second EOF just written. If the file was 
no-rewind and opened read-only, the tape is positioned after the EOF following the data just read. Once 
opened, reading is restricted to between the position when opened and the next EOF or the last write. The 
EOF is returned as a zero-length read. By judiciously choosing ml files, it is possible to read and write 
multi-file tapes. 

A standard tape consists of several 512 byte records terminated by an EOF. To the extent possible, the sys¬ 
tem makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual meaning and 
it is possible to read or write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ¬ 
ten, the “raw” interface is appropriate. The associated files are named rmtO, ..., rmtlS. Each read or 
write call reads or writes the next record on the tape. In the write case the record has the same length as the 
buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. An EOF is returned as a zero-length read, with the tape positioned after the EOF, so that the 
next read will return the next record. 

EILES 

/dev/mt*, /dev/rmt* 

BUGS 

If any non-data error is encountered, it refuses to do anything more until closed. Note that during a rewind 
or space-forward operation, control is not returned until the operation has completed. The driver is limited 
to one transport. 
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NAME 

tty - controlling terminal interface 

DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the control terminal associated with the process group 
of that process, if any. It is useful for programs or shell sequences that wish to be sure of writing messages 
on the terminal no matter how output has been redirected. It can also be used for programs that demand the 
name of a file for output, when typed output is desired and it is tiresome to find out what terminal is cur¬ 
rently in use. 

EILES 

/dev/tty 

/dev/tty* 

SEE ALSO 

dz(7), tn4(7), tn74(7). 
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NAME 

tu78 - TU78 magnetic tape interface 

DESCRIPTION 

The files mtO, mtlS refer to the Digital Equipment Corporation TU78 magnetic tape control and trans¬ 
ports. The files mtO, mt7 are 1600bpi, and the files mt8, mtlS are 6250bpi. The files mtO, mt3, 
mt8, mill are designated normal-rewind on close, and the files mt4, mt7, mtl2, mtlS are no¬ 
rewind on close. When opened for reading or writing, the tape is assumed to be positioned as desired. 
When a file is closed, a double end-of-file (double tape mark) is written if the file was opened for writing. 
If the file was normal-rewind, the tape is rewound. If it is no-rewind and the file was open for writing, the 
tape is positioned before the second EOF just written. If the file was no-rewind and opened read-only, the 
tape is positioned after the EOF following the data just read. Once opened, reading is restricted to between 
the position when opened and the next EOF or the last write. The EOF is returned as a zero-length read. By 
judiciously choosing ml files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512 byte records terminated by an EOF. To the extent possible, the sys¬ 
tem makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual meaning and 
it is possible to read or write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ¬ 
ten, the “raw” interface is appropriate. The associated files are named rmtO, ..., rmtlS. Each read or 
write call reads or writes the next record on the tape. In the write case the record has the same length as the 
buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. An EOF is returned as a zero-length read, with the tape positioned after the EOF, so that the 
next read will return the next record. 

EILES 

/dev/mt*, /dev/rmt* 

BUGS 

If any non-data error is encountered, it refuses to do anything more until closed. The driver is limited to 
four transports. 

SEE ALSO 

gt(7), ht(7). 
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NAME 

un32 - magnetic tape interface 

DESCRIPTION 

The files tp? and tp?ii refer to the UN32 magnetic tape controllers and associated transports. Only 1600bpi 
is available. The files tp? are designated normal-rewind on close, and the files tp?n are no-rewind on 
close. When opened for reading or writing, the tape is assumed to be positioned as desired. When a file is 
closed, a double end-of-file (double tape mark) is written if the file was opened for writing. If the file was 
normal-rewind, the tape is rewound. If it is no-rewind and the file was open for writing, the tape is posi¬ 
tioned before the second EOF just written. If the file was no-rewind and opened read-only, the tape is posi¬ 
tioned after the EOF following the data just read. Once opened, reading is restricted to between the position 
when opened and the next EOF or the last write. The EOF is returned as a zero-length read. By judiciously 
choosing tp files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512 byte records terminated by an EOF. To the extent possible, the sys¬ 
tem makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual meaning and 
it is possible to read or write a byte at a time (although very inadvisable). 

The tp files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ¬ 
ten, the “raw” interface is appropriate. The associated files are named rtp? and rtp?ii. Each read or write 
call reads or writes the next record on the tape. In the write case the record has the same length as the 
buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the count cannot be greater than 
2048 bytes. Seeks are ignored. An EOF is returned as a zero-length read, with the tape positioned after the 
EOF, so that the next read will return the next record. 

EILES 

/dev/tp*, /dev/rtp* 
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NAME 

un52 - magnetic tape interface 

DESCRIPTION 

The files tp?, tp?h, tp?ii and tp?hn refer to the UN52 magnetic tape controllers and associated transports. 
Only 1600bpi is available on the UN52, while 1600/6250bpi densities are available on the UN52B. The 
files are designated tp? for IbOObpi rewind-on-close, tp?n for IbOObpi no-rewind on close, tp?h for 
6250bpi rewind-on-close, and tp?hii for 6250bpi no-rewind on close. 

The tape is assumed to be positioned as desired when opened. If the file was opened for writing a double 
file mark is written on the tape when closed; if the file was normal-rewind, the tape is rewound, otherwise 
the tape is positioned before the second file mark. If the file was opened read-only, and if the file was 
normal-rewind, the tape is rewound, otherwise the tape is positioned after the file mark following the data 
just read. Once opened, reading is restricted to between the position when opened and the next file mark or 
the last write. A file mark is returned as a zero-length read. 

A standard tape consists of several 512 byte records terminated by a file mark. To the extent possible, the 
system makes it possible to treat the tape like any other file. Seeks have their usual meaning and it is possi¬ 
ble to read or write a byte at a time (although inadvisable). 

The tp files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, or when large records are to be read or written, the 
“raw” interface is appropriate. The associated files are named rtp?, rtp?n, rtp?h and rtp?hii. Each read 
or write call reads or writes the next record on the tape. During a write, the record has the same length as 
the buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer 
size specified. If the record was larger than the buffer size, the extra data is discarded. The buffer must 
begin on a word boundary, and the count must be an even number and cannot be greater than 6144 bytes. 
Seeks are ignored. 

EILES 

/dev/tp*, /dev/rtp* 

BUGS 

Once a file mark or any drive error is encountered, it refuses to do anything more until closed. 
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NAME 

un53 - UN53/TN82 synchronous device interface 

DESCRIPTION 

The hies un53* refer to the UN53 synchronous communications devices. Each physical UN53/TN82 pair 
provides for either one high speed (up to 50KB) or three low speed (up to 9.6KB) synchronous communica¬ 
tions line(s). 

The device interface permits simultaneous communication on multiple logical devices on a single 
UN53/TN82 pair. 

EILES 

/dev/un53* logical communications lines. 
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NAME 

vp - Versatec printer 

DESCRIPTION 

Vp provides the interface to the Versatec electro-static line printer. Both printing and plotting capabilities 
are implemented. 

Two ioctl(2) system calls are available: 

#include <sys/lprio h> 
ioctl (hides, command, arg) 
int arg; 

The commands are: 

LPRGETV Return the state of the printer. 

LPRSETV Set the state of the printer to arg. 

PILES 

/dev/vp 

SEE ALSO 

vpr(l), lp(7). 
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NAME 

vpm - Virtual Protocol Machine 

DESCRIPTION 

This entry describes the VPM protocol driver and gives an introduction to the Virtual Protocol Machine 
(VPM). 

VPM is a software package for implementing link-level protocols on Programmable Communication 
Devices (PCDs) in a high-level language. This is accomplished by a compiler that runs on the UNIX System 
and translates a high-level language description of a protocol into an intermediate language that is executed 
by the PCD. 

The VPM software consists of the following components: 

1. A compiler (yf>mc(lM)) for the protocol description language; it runs on the UNIX System. 

2. A program that controls the overall operation of the PCD and executes the protocol script. 

3. A protocol driver. 

4. vpmstart: a UNIX System command that copies a load module into the PCD and starts it. 

5. vpmset{\M): a UNIX System command that logically connects VPM minor devices with PCD syn¬ 
chronous lines. 

6. vpmsave{\M)\ a UNIX System command that writes unformatted trace data to its standard output. 

7. vpmfint: a UNIX System command that formats the output of vpmsave{lM). 

Operation of the VPM Protocol Driver 

The VPM protocol driver provides a simple user interface to a synchronous line controlled by a link-level 
protocol executing in a PCD. It supports the following UNIX system calls: open, read, write, close, and 
ioctl. If higher levels of protocol are required, the VPM protocol driver may be modified or replaced. 

The VPM protocol driver communicates with the level 2 protocol executing in the PCD using the Common 
Synchronous Interface (CSI). CSI is a device-independent interface between a level 3 protocol executing as 
part of the UNIX operating system and a level 2 protocol executing in a PCD. The interface consists of pro¬ 
cedure calls implementing a number of commands and reports. 

Before a VPM protocol driver minor device can be used, it must be logically connected to a synchronous 
line of some PCD. This connection can be made by means of ioctl commands (see below). The command 
vpmset{\M) uses these ioctl commands to make these connections. 

This driver allows a UNIX System user processes to transfer data to or from a remote terminal or computer 
system through VPM. Flow control and error recovery are provided by the level 2 protocol executed by the 
PCD. 

The VPM protocol driver open for reading-and-writing is exclusive; opens for reading-only or writing-only 
are not exclusive. The open sends a command to the PCD which causes it to start executing the protocol. 
The protocol driver then supplies one or more 512-byte receive buffers to the PCD. 

The read returns either the number of bytes requested or the number remaining in the current receive 
buffer, whichever is less; any remaining bytes in the current receive buffer are used to satisfy subsequent 
reads. The data from each user write is copied into one or more 512-byte buffers and passed to the PCD for 
transmission. 

The close arranges for the return of buffers and for a general cleanup when the last transmit buffer has been 
returned by the interpreter. It also stops the execution of the protocol. 

The VPM protocol driver ioctl system call has the form: 

ioctl (hides, cmd, arg) 

Possible values for the cmd argument are: 

VPMCMD-Send a command to the protocol script. The hrst four bytes of the array pointed to by arg are 
passed to the PCD, which saves them and passes them to the protocol script when it requests them 
via a getcmd primitive. Only the most recent command is kept by the PCD. 
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VPMERRSET-Set the maximum values for the error counters to the values in the array pointed to by arg. 
The array is assumed to contain eight (short) values. When a VPMERRS ioctl is executed the VPM 
protocol driver returns the current values of the error counters and sets them to the values dehned 
by the VPMERRSET command. The error counters are then decremented when errors occur until 
they reach zero. If VPMERRSET is not done all reset values will default to zero. If a reset value is 
zero the corresponding error counter will be ignored. 

VPMERRS-Get and then reset the error counters. The error counters are copied to the array pointed to by 
arg, which must be large enough to contain eight (short) counters. The error counters are then set 
to the values specihed by a previous VPMERRSET, if any, zero otherwise. 

VPMRPT-Get the latest script report. When the protocol script executes a rtnrpt primitive, a four-byte 
report is passed from the protocol script to the VPM protocol driver which saves it for later use. 
Only the most recent script report is kept by the driver. If there is a script report that has not previ¬ 
ously been passed to a user via this ioctl command, that report is copied to the array pointed to by 
arg and a 1 is passed as the return value. If no script report is available, a zero is passed as the 
return value. 

VPMSDEV-Connect a protocol driver minor device to a synchronous line of a PCD. Arg is an int contain¬ 
ing the major and minor device numbers of the PCD. When using a DEC PCD the synchronous line 
number is encoded in bits 5-7 of the major/minor device number. To invoke this ioctl command, 
the hie status hag O NDELAY must be set. 

VPMDETACH-Disconnect the protocol driver minor device and the PCD synchronous line. To invoke this 
ioctl command, the hie status hag O NDELAY must be set. 

VPMOPTS-Set the protocol options. The previous options are cleared and the options represented by arg 
are set. The protocol options may be retrieved by the protocol script using the getopt primitive 
(see yf>mc(lM)). When running cslapb.r as the level 2 protocol script, an octal 01 in arg will indi¬ 
cate to the script that it should use the B address (see vpmset{\M)). To invoke this ioctl command, 
the hie status hag O NDELAY must be set. 

VPMPCDOPTS-Set the PCD options. If the PCD requires options, the previous options are cleared and the 
option represented by arg are set. To invoke this ioctl command, the hie status hag O NDELAY 
must be set. The following constants, which may be combined with the OR operator to form arg, 
apply only to the HDLC versions of the VPM interpreter as implemented on the DEC KMC and 
KMS: 

HWLOOP-This option causes the interpreter to set maintenance loopback mode on the syn¬ 
chronous line interface associated with a particular line. This option is used by vpmtest{\M). 

ADRSWTCH-This option causes the interpreter to invert (complement) the address bit (bit 2 of 
byte 0) of each transmitted frame. This allows the BX.25 level 2 protocol script cslapb.r to operate 
in a loopback mode. This option is used by vpmtest{\M). 

X25MODE-If this option is set, the interpreter places the hrst three bytes of the data portion of 
each received frame into the octet portion of the buffer descriptor instead of into the data buffer. 
Similarly, the first three bytes of the data portion of each transmitted frame are taken from the 
octet portion of the buffer descriptor. This mode is used by the PDPl 1 version of the BX.25 level 3 
driver. 

VPMSTAT-This puts into the integer variable pointed to by arg the CSI index associated with the protocol 
minor device. 

The VPM Event Trace 

The VPM protocol driver and CSI routines generate a number of event records to allow the activity of the 

protocol driver, the interface routines and the protocol script to be monitored for debugging purposes. If a 

program such as vpmsave{\M) has opened minor device 0 of the trace driver and has enabled the 
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appropriate channels on that device, these event records are queued for reading; otherwise the event records 
are discarded by the trace driver. Event records associated with CSI interface index n modulo 16 are put on 
the read queue for minor device 0 of the trace driver with a channel number of n. Calls to the system func¬ 
tions vpmopen, vpmread, vpmwrite, and vpmclose generate event records identified respectively by open, 
read, write, and close when the output of vpmsave is formatted and printed by vpmfmt. Calls to the 
yf>mc(lM) primitive trace{argl, arg2) cause the PCD to pass argl and arg2 along with the current value of 
the script location counter to the VPM driver, which generates an event record identified by trace. 

When the script terminates for any reason, the driver is notified and generates an event record identified by 
INTterm. This record also contains the CSI minor device number, the script location counter, and a termi¬ 
nation code; the code indicates the reason for termination as follows: 

0 Normal termination; the PCD received a HALT command from the driver. 

1 Undefined virtual-machine operation code. 

2 Script program counter out of bounds. 

3 Interpreter stack overflow or underflow. 

4 Jump address not even. 

5 UNIBUS error. 

6 Transmit buffer has an odd address; or the driver tried to give the PCD too many transmit buffers; 
or a get or rtnxbuf was executed while no transmit buffer was open, i.e., no getxbuf was executed 
prior to the get or rtnxbuf. 

1 Receive buffer has an odd address; or the driver tried to give the PCD too many receive buffers; or 
a put or rtnrbuf was executed while no receive buffer was open, i.e., no getrbuf was executed prior 
to the get or rtnxbuf. 

8 The script executed an exit primitive. 

9 A crcl6 was executed without a preceding crcloc execution. 

10 The PCD detected loss of the modem-ready signal at the modem interface. 

11 Transmit-buffer sequence-number error (internal error). 

12 Command error: an invalid command or an improper sequence of commands was received from 
the driver. 

13 Not used. 

14 Invalid transmit state (internal error). 

15 Invalid receive state (internal error). 

16 Not used. 

17 Xmtctl or setctl attempted while transmitter was still busy. 

18 Not used. 

19 Same as error code 6. 

20 Same as error code 7. 

21 Script too large. 

22 Used for debugging the PCD. 

23 The driver’s OK-check has timed out. 

24 The array specified as an argument to a getcmd primative is too close to end of user’s data space in 
the PCD. 

25 PCD driver unable to accept command. 

26 The PCD’s OK-check has timed out. 

27 No such line number on PCD. 

SEE ALSO 

vpmc(lM), vpmsave(lM), vpmset(lM), trace(7), x25(7). 
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NAME 

x25 - BX.25 network interface 

DESCRIPTION 

The X25 driver provides multiplexed channels over one or more synchronous communications lines using 
the Bell System standard BX.25 Level 3 protocol. The current implementation supports permanent virtual 
circuits (PVCs) only; the call set-up features needed to support virtual calls have not yet been implemented. 
There is a separate and independent Level 3 interface for each communications line. Point-to-point connec¬ 
tions between hosts are supported as well as connections via an X.25 network. 

The X25 uses the Common Synchronous Interface (CSI) to access communications lines controlled by vari¬ 
ous kinds of programmable communications devices (PCDs). Level 2 of BX.25, the link level, is imple¬ 
mented by software or firmware in the PCD. On DEC machines, the PCD is a DEC KMCl 1-B microproces¬ 
sor, using the Protocol Machine (VPM) software package. On the 3B20S, the PCD is 

a TN75B or TN82 peripheral controller. 

The special files /dev/x25/s.^ refer to the minor devices of the X25 driver. Each such minor device, also 
referred to as a slot, can be connected by means of a network control device (see nc{7)) to an arbitrary logi¬ 
cal channel (1-4095) on a specified X25 interface. Provided the other end of the logical channel has been 
connected in an analogous fashion, each slot so connected is the terminus of a permanent virtual circuit, 
which is a full-duplex connection between a set of user processes on the local host and another set of user 
processes on a remote host. A logical channel is a connection which may be multiplexed with other chan¬ 
nels over a physical link to a remote host or an X.25 network. Each X25 interface (also referred to as a link) 
must be connected via the network-control device to a particular synchronous line. 

The X.25 driver includes the BX.25 link backup facility. This facility provides for automatic changeover to 
a backup synchronous line which may be configured for any X25 interface. A changeover could occur for 
several reasons: if there is a failure on the link, i.e. physical severing of the link (Level 1) or a failure at 
Level 2; the link is noisy and produces too many errors; a changeover to the backup link is requested via 
the nc device; or the remote end of the link initiates a changeover. Level 3 will be unaware of the change¬ 
over and any lost packets will be recovered by the Level 3 recovery procedures. The procedures for 
configuring backup links and requesting a changeover to the backup link are described in the manual entries 
for x25pvc(lM) and nc(7). 

A user process accesses a BX.25 minor device (slot) using open, close, read, write, and ioctl system calls. 

There are several internal flags that are maintained by the X25 driver for each slot. The values of these 
flags can be read and in some cases modified by means of the ioctl system call (see below). 

An open and return the error ENXIO if the specified slot is not configured, ENODEV if the slot is not cur¬ 
rently connected to a logical channel on some link, or EL3HLT if the link to which the slot is connected is 
not currently active. The user may request the normal open options O RDONLY, O WRONLY, and 
O RDWR. The user may also request that reads with no data available should not sleep by using the 
O NDELAY open flag, or that the open is to be exclusive by using the O EXCL open flag. If an exclusive 
open is requested and the slot is already in use, the error EACCES will be returned. A successful open will 
clear the isreset status bit (see the discussion of ioctl below). 

An open may or may not block until the far end is also open, depending on the session-establishment proto¬ 
col requested. The choice of session-establishment protocol is made by means of the network-control 
device at the time the permanent virtual circuit is installed. There are three possibilities: the first mode, 
referred to as the ‘ ‘no-protocoT ’ session mode, is for the open to return immediately. This puts the burden 
on the user program to determine whether the far end is actually open. The reset session mode, intended 
only for compatibility with certain non-UNIX System implementations of BX.25, uses a RESET in-order 
packet to indicate to the far end that the slot has been opened and a RESET out-of-order packet to indicate to 
the far end that the slot has been closed. In the current implementation, the RESET in-order and RESET 
out-of-order packets are recognized when they are received, but are not transmitted (so-called “passive” 
mode). To avoid data loss with this mode, the application on the non-UNIX System side must wait until it 
receives data from the UNIX System side (allow the UNIX System side to perform the first write) before it 
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sends any data to the UNIX System. The third mode, which is the one recommended for most applications, 
uses BX.25 session-layer Connect/Accept qualihed data messages to indicate that a slot has been opened 
and session-layer Disconnect qualihed data messages to indicate that a close has occurred. In the last two 
modes, an open will block until the indication that the far end is open has been received, unless the 
O NDELAY open option was specihed, in which case the status of the far end of the PVC must be obtained 
by using ioctl (see below). 

Regardless of the session-establishment protocol in effect, data which is received while a slot is not open 
will be acknowledged and silently discarded. However, if the session-layer open!close protocol is selected, 
no data can be transmitted until both ends of the PVC have been opened. 

The data specihed by each write is transmitted as a single BX.25 message, possibly multi-packet. The user 
has the option of waiting for acknowledgement of the last packet of each message before the write returns; 
this feature is called delivery confirmation (see the discussion of ioctl below). Even if the O NDELAY 
mode was requested, the user process will be put to sleep if the amount of data in the transmit queue for the 
slot exceeds some high-water mark; the process will be given a wake-up when the transmit queue has been 
drained to the low-water mark. If the slot is not open for writing and a write system call is issued, the error 
EBADF is returned. 

A user reads in record mode, which means that each read will return data from a single message only. If 
the slot is not open for reading and a read system call is issued, the error EBADF is returned. If the count 
specihed on the read request is not large enough to accommodate the entire message, the remainder of the 
message will be returned on subsequent reads. The message-continued hag (messconf) will be set when a 
partial read occurs; this hag will be cleared when the last byte of the message is hnally read. If no data is 
available, the user process will be put to sleep, unless the O NDELAY option was specihed on the open or 
the equivalent mode was set via an fcntl system call. If O NDELAY was specihed and no data is available, 
the read will return zero bytes. If a partial message is available and O NDELAY has been set, the read will 
return zero until the end of the message has been received or the count can be hlled. However, if the chan¬ 
nel is how-controlled, the read will return the partial message even if O NDELAY is set. If O NDELAY is 
not set, the read will sleep until the entire message has been received or the count has been satished. 

Zero-length messages will be sent and received as such (but see BUGS below). 

If the faropen hag (described below) is not set, a write will return immediately with a count of zero. A read 
will return a zero-length record (indicating end-of-hle) if faropen is not set and the receive queue is empty. 
If the end of a message is on the input queue, a read will not return a zero indicating end-of-hle, regardless 
of the state of the slot. Note that this means that the hags returned by ioctl, indicating that the far end has 
closed or a RESET has occurred, may be set before they take effect on user reads. 

Except as just noted, once a RESET has occurred (indicating possible data loss), all reads and writes will 
fail, returning the error EL3RST, until the isreset hag is cleared by an ioctl or a successful open. 

If the state of the channel is halted, all calls to the BX.25 subsystem for that channel will fail with error 
EL3HLT. This occurs when a link dies or a severe error causes the protocol to be stopped on the channel or 
link. If the channel is not in the halted state but level 2 has lost synchronization, the error EL2NSYNC is 
returned. 

Signals will cause reads and writes to return the amount actually read or written, unless it was zero bytes, in 
which case the error EINTR will be returned. However, if O NDELAY was specihed, the amount actually 
read or written will be returned, whether zero or greater. If a write is interrupted by a signal, the data 
already packetized will be transmitted as a BX.25 message; that is, a subsequent write will always begin a 
new message. The return value from the write will indicate the number of bytes actually queued for trans¬ 
mission. 

When the last user closes, any unread data in the receive queue will be discarded. Data in the transmit 
queue will not be discarded, but will be transmitted normally. When the transmit queue has been drained, 
the session take-down protocol, if any, is then followed (either to send a session-layer Disconnect message 
or to mark the channel as being out of use, so that incoming packets can be discarded). 
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Several options and actions can be requested via the ioctl system call, which takes three arguments: 
request, and arg. To use this ioctl system call, the line 

#include <sys/x25user h> 

must be included in the user program. Possible values for the request argument are: 

X25SET Set the flags and options for the slot or channel. 

X25GET Return the status information for the channel and its associated link. The structure 
pointed to by arg will receive the values described below. 

The structure pointed to by arg for X25SET is: 

struct x25sctl { 
ushort 

c_delconf: 1, /* delivery confirmation */ 
c_isreset: 1, /* channel reset not cleared */ 
c_ndelay : 1; /* no delay requested */ 

}; 


Only the delconf md isreset flags can be changed by ioctl. 

The flag bits are further explained as follows: 
c_delconf 

While this bit is set, each write system call will block until the last packet of the corresponding mes¬ 
sage has been acknowledged; another writer, if one exists, will also be blocked until the previous 
writer’s message is acknowledged. If this bit is not set, a user write can return immediately after the 
message has been completely packetized and queued for transmission, possibly allowing several out¬ 
going messages to be unacknowledged at the same time. 


cjsreset 

This flag if set indicates that a RESET has occurred. The user may clear this flag by setting the corre¬ 
sponding flag bit to 1 in the value passed by X25SET. (The user may not set this flag). If the value 
for this flag passed by X25SET is 0, the internal value of this flag will not be changed. This flag is 
always cleared by a successful open. 

cjhdelay 

This flag if set indicates that the O NDELAY flag has been set. If this flag is not set on an open sys¬ 
tem call, it can be set or cleared on the/cnfZ system call. The value of this bit may not be changed by 
using the ioctl system call. 

The structure pointed to by arg for X25GET is: 


struct 


x25gctl { 
struct t_state 
struct l_state 
struct s_flags 
unsigned char 
unsigned char 
unsigned char 
struct l_line 
struct 1 line 


c_t_state; 

c_l_state; 

c_s_flags; 

c_xmtq; 

c_recvq; 

c_rststate; 

c_primline; 

c_bckline; 


/* tab state structure */ 

/* link state structure */ 

/* slot flags structure */ 

/* length of lev 3 xmtq */ 
/* length of lev 3 recvq */ 
/* restart state of link */ 

/* primary line info */ 

/* backup line info */ 


The structure returned contains information about the channel and its associated link. Macros are provided 
to obtain some of the more useful information. These macros are especially useful in determining the con¬ 
ditions of the channel and link when a system call to a BX.25 minor device returns an error indicating an 
abnormal situation. To use the macros, a user must issue an ioctl using the file descriptor of the BX.25 
minor device. Each macro has an argument arg which is a pointer to an x25gctl structure. The following 
macros are provided: 
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X25LRDY true if the link has completed restart procedures 

X25LHLT true if the link is halted 

X25L2FUL true if the level 2 queue of the link is full 

X25ABNHLTP true if the link is halted because of an abnormal condition on the primary device 

X25NRMHLTP true if the link is halted because of a normal halt command on the primary device 

X25L2ERRP the value of the error code returned by the primary device when it last halted 

X25L2RDYP true if level 2 is synchronized on the primary device 

X25L2FCP the number of times the level 2 retry counter reached its maximum 

X25LATCFIP true if the link is attached to a primary device 

X25CF1LT true if the state of the channel is halted 

X25CRDY true if the channel is in the data transfer state 

X25FAROPN true if the far end of the channel is open 

X25ISRESET true if the channel has just completed reset procedures 

X25MSGCON true if the message was not completely consumed by last user read 

X25L3XQFUL true if the level 3 transmit queue is full 

X25L3RQFUL true if the level 3 receive queue is full 

In order to access information not obtained using the macros, the user may look at the structures declared in 
/usr/include/sys/x25u.h and /usr/include/sys/x25.h to determine how to access the desired values directly. 

The following is an example of a situation where an ioctl call would be useful. Assume that only a primary 
device has been attached to the link associated with the channel being used. If the error EL3F1LT is returned 
when a system call is issued, an ioctl call would then be issued. The EL3HLT error return indicates that the 
link is in the halted state and the macros can provide more useful information. The macro UABNHLTP(arg) 
will return true if the link halted abnormally. The macro UL2ERRP(arg) will then return the value of the 
error code returned by the primary device. The manual entry vpm{7) describes what the error codes mean 
and the file /usr/include/sys/csierrs.h contains defines for these errors. If the link halted normally, this indi¬ 
cates that someone entered a command to halt the link. 

SEE ALSO 

x25pvc(lM), fcntl(2), ioctl(2), open(2), read(2), write(2), nc(7), vpm(7). 

Operations Systems Network Protocol Specification: BX.25 Issue 2. 

BUGS 

The multiplicity of options for the open/close protocol reflects a lack of standardization and a certain 
amount of confusion. However, in the near future, the session layer will be implemented and will handle 
this problem so that the user will not have to select an option or have to worry about open/close synchro¬ 
nization. 

It is not clear that the treatment of the O NDELAY flag is correct; this is an area that is particularly likely to 
change. In particular, the read partial message/return zero dilemma for read O NDELAY calls is puzzling. 
One would like to return zero until the entire message has been received, but a long, multi-packet message 
could deadlock such a scheme. Thus, the “read something if flow-controlled” method was used. 

At present, there is no way to tell whether a return value of zero for a no-delay read is due to a zero-length 
message or to the lack of anything to read. 

It would be dangerous to assume that zero-length messages will be propagated correctly through an X25 
network or that they will be treated in a compatible manner by other implementations of BX.25. 

There is no way to send an INTERRUPT packet. An INTERRUPT packet received from the far end will be 
confirmed and discarded. 
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NAME 

intro - introduction to system maintenance procedures 

DESCRIPTION 

This section outlines certain procedures that will be of interest to those charged with the task of system 
maintenance. Included are discussions on such topics as boot procedures, recovery from crashes, file back¬ 
ups, etc. 

BUGS 

No manual can take the place of good, solid experience. 


Page 1 



3B20 BOOT(8) 


(3B20S only) 


3B20 BOOT(8) 


NAME 

3B20boot - 3B20S bootstrap procedures 

DESCRIPTION 

Lboot is a program that is read in from the boot section of the disk in response to the BOOT command on 
the EAI page at the console. See eai{%) for a description of the console operations. Other options specified 
on the EAI page control the functions performed by lboot. 

If the SEC-DISK flag is clear on the EAI page when the BOOT command is issued, moving head disk 0 is 
used as the boot device. If the SEC-DISK flag is set, moving head disk 1 will be used as the boot device. 
The BACKUP-ROOT flag controls which one of two file systems on the chosen disk will be used. If the flag 
is clear, the primary root file system on the disk will be used. If the flag is set, the backup root file system 
will be used. 

The PROMPT-UNIX System flag is used to specify the name of the program to be booted. If the 
PROMPT-UNIX System flag is clear, /unix on the chosen file system will be booted. If the PROMPT-UNIX 
System flag is set, lboot will ask for the name of the program to be booted. (NOTE: To respond to lboot, 
you must be out of the EAI command area. Use the NORM DISP or CMD-MSG key to get out of the com¬ 
mand area.) If the name given is a directory on the chosen file system, lboot will respond with a listing of 
the files present in the directory. If the name given is a normal, executable file in a.out format, it will be 
loaded into memory and control will be transferred to it. 

Any standard /unix file will look at the MIN-CONFIG and INH-CACHE flags when it begins execution. If 
the MIN-CONFIG flag is clear, all of the peripheral devices will be brought into service. See don{\M) for 
the normal device configuration mechanism. If the MIN-CONFIG flag is set, /unix will only bring the boot 
device, the system console, and a tape drive into service and only the first megabyte of main memory will 
be used. If the INH-CACHE flag is set, /unix will leave the cache memory disabled. If the INH-CACHE flag 
is clear, the cache will be enabled. 

SEE ALSO 

don(lM), newboot(lM), dsk(7), eai(8), prm(8). 

DIAGNOSTICS 

Self-explanatory messages about bad directory entries and bad file formats. The following code words are 
used in success PRMs: 

Code Meaning 

dfcn DEC number 

dskn Moving head disk number 

The success PRM’s issued during the boot process are: 



PRM 


Meaning 

ElOO 

0000 

dfcn 

dskn 

DEC is in service 

ElOO 

BBBB 

3B3B 

3B3B 

Specified program loaded into memory 

E200 

0000 

0000 

OADD 

UNIX System is checking memory 

E200 

0000 

0000 

0001 

UNIX System is initializing I/O devices 

E200 

0000 

0000 

0002 

UNIX System is ready to mount ROOTDEV 

ECOO 

3B3B 

3B3B 

3B3B 

UNIX System is ready to run user processes 

Eailure PRM’s can be found in prm{%). 



BUGS 

Lboot never uses the cache memory. Lboot isn’t smart enough to know what a.out files can be used as 
bootable programs. If an a.out is specified that is not a bootable program, lboot will load it in and branch to 
it. What happens after that is unpredictable. 
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NAME 

3B20ops - 3B20S console operations 

DESCRIPTION 

The daily procedures involved in running the UNIX System on the 3B20S system are described here. 

Disk Boot 

See 3B20boot{%) for a complete description of how to boot the machine from disk. The # prompt indicates 
that the system has come up through init S (see /n/f(lM)) and that the shell is ready to accept commands. 

This is the appropriate time to do file system backups, and/icA:(lM) should be executed. One must never 
operate the system with a defective file system. 

After successful completion of fsck, the operator can bring the system to multi-user operation by executing 

init 2. 

Bringing the System Down 

The shutdown procedure is designed to gracefully turn off all processes and bring the system back to single 
user state with all buffers flushed. To do this the operator can execute shutdown{\M) or the following 
sequence of commands: 

killall 
sync 
telinit 6 
fsck (optional) 

The system may then be halted using the Emergency Action Interface (see ea!(8)). 

System Dumps 

After a system crash the procedure outlined in ea/(8) should be followed to dump the contents of memory 
to the disk. Then the dump can be analyzed using crash{\M) and the /dev/dump.^ file (see dsk(7)). To 
save the dump for later examination, the dump may be copied to a file using the command: 

dd if=/dev/dumpf/ of=saveflle 

where U is the unit (drive) number of the disk containing the dump. 

SEE ALSO 

crash(lM), date(l), fllesave(lM), fsck(lM), init(lM), shutdown(lM), system(4), 3B20boot(8), eai(8). 
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NAME 

70boot - 11/70 bootstrap procedures 

DESCRIPTION 

To bootstrap programs from a wide range of storage media, the PDP-11/70 has a dedicated diagnostic boot¬ 
strap loader called the M9301-YC. The M9301-YC contains two 256 word ROMs (17 765 000 to 
17 765 776 and 17 773 000 to 17 773 776) which contain hardware verihcation diagnostic routines and 
bootstrap loader routines. 

The diagnostic portion tests the basic CPU to verify correct operation. The branches, registers, all address¬ 
ing modes, and most of the instructions are checked. If requested, memory management and the UNIBUS 
map are turned on. Then memory is tested from virtual address 001 000 to 157 776 with the cache dis¬ 
abled. Next the cache is enabled and tested. 

The physical memory tested is determined by the console switches. Console switches <15:12> are used to 
set physical address bits <19:16>. If console switches <15:12> are zero, memory management and the 
UNIBUS map will not be enabled, so that physical memory 0 to 157 776 will be used. If console switches 
<15;12> are non-zero, then memory management, the UNIBUS map, and 22-bit mapping will be enabled. 
Table 1 describes the physical address ranges for each switch setting. In all cases, virtual addresses 160 000 
to 177 776 are mapped to the peripheral page, physical addresses 17 600 000 to 17 777 776. Note that 
physical memory above 512K words is not accessible by this program even though the physical memory 
maximum is 1920K words. 

The bootstrap portion of the M9301-YC attempts to BOOT from the device and drive number specihed in 
the console switches. Console switches <7:3> select the device and console switches <2:0> select the drive 
number. Table 11 describes the devices selected for each switch setting. If console switches <7;0> are zero, 
the program will read a set of switches on the M9301-YC, set by held service, to determine a default boot 
device and drive number. These switches appear at location 17 773 024, however bits <8:4> select the 
device and bits <3:1> select the drive number. 

Having selected a boot device, the program will read a block of data into memory starting at virtual address 
0, and then jump to virtual address 0. Table III describes the details of booting for each device. Note that 
the physical address selection is the same as described above for the diagnostic portion. Excluding the 
RXl 1/RXOl hoppy disk, bootstrap programs must ht in one block of 256 words, even though this program 
may read in more. 

To start operation of the bootstrap loader, halt the CPU by depressing the HALT switch, set the Address Dis¬ 
play select switch to Console Physical, set the Console Switch Register to 165 000, and depress the Load 
Address switch. Then reset the console switches to 0 and set switches <15;12> for the desired physical 
memory (normally 0) and switches <7:0> for the desired device (normally 0 for the default boot). Put the 
HALT switch in the ENABLE position and depress the START switch. The diagnostic portion will then run 
followed by the boot from the selected media. This takes approximately three seconds. 

Any error during the diagnostic portion will cause the CPU to halt. Table IV lists the addresses and error 
indications. Only cache errors are recoverable in that by pressing the CONTINUE switch the program will 
disable the cache by forcing misses and proceed to the bootstrap section. If there is an error in reading the 
boot block, the program will do a RESET instruction and jump back to the memory test section (test 24) and 
then attempt to boot again. 

SEE ALSO 

romboot(8), unixboot(8). 
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Table I - Physical Memory Selection 


Console switches <15:12> Physical addresses 


00 

00 000 000 - 00 157 776 

01 

00 200 000 - 00 357 776 

02 

00 400 000 - 00 557 776 

03 

00 600 000 - 00 757 776 

04 

01 000 000 - 01 157 776 

05 

01 200 000 - 01 357 776 

06 

01 400 000 - 01 557 776 

07 

01 600 000 - 01 757 776 

10 

02 000 000 - 02 157 776 

11 

02 200 000 - 02 357 776 

12 

02 400 000 - 02 557 776 

13 

02 600 000 - 02 757 776 

14 

03 000 000 - 03 157 776 

15 

03 200 000 - 03 357 776 

16 

03 400 000 - 03 557 776 

17 

03 600 000 - 03 757 776 

Table II - Device selection 

Console switches <7:3> 

Device 

00 

illegal 

01 

TM11 /TU10 Magnetic tape 

02 

TC11/TU56 DECtape 

03 

RKl 1/RK05 Disk pack 

04 

RPl 1/RP03 Disk pack 

05 

reserved 

06 

RH70/TU16 Magnetic tape 

07 

RH70/RP04 Disk pack 

10 

RH70/RS04 Fixed head disk 

11 

RXll/RXOl Diskette 

12-37 

illegal 
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TUIO: 


TU56: 
RK05 or 
RP03: 
TU16: 


RP04; 


RS04; 

RXOl: 


Table III - Boot procedures 

Select drive, wait until online, 

set to 800 bpi, rewind, 

space forward 1 record, 

read 1 record (maximum of 256 words). 

Select drive, rewind, read 512 words. 

Select drive, start at block 0, read 512 words. 

Select drive on first TM02, wait until online, 

set to 800 bpi, PDP format, rewind, 

space forward 1 record, 

read 1 record (maximum of 512 words). 

Select drive, read-in preset, 

set to 16-bits/word, ECC inhibit, 

start at block 0, read 512 words. 

Select drive, start at block 0, read 512 words. 
Select drive 0 or 1, 

start at track 1, sector 1 (IBM standard), 
read 64 words. 
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Table IV - Error halts 


Address displayed 

Test 

Subsystem under test 

17 765 004 

1 

Branch 

17 765 020 

2 

Branch 

17 765 036 

3 

Branch 

17 765 052 

4 

Branch 

17 765 066 

5 

Branch 

17 765 076 

6 

Branch 

17 765 134 

7 

Register data path 

17 765 146 

10 

Branch 

17 765 166 

11 

CPU instruction 

17 765 204 

12 

CPU instruction 

17 765 214 

13 

CPU instruction 

17 765 222 

14 

CPU instruction 

17 765 236 

14 

CPU instruction 

17 765 260 

15 

CPU instruction 

17 765 270 

16 

Branch 

17 765 312 

16 

CPU instruction 

17 765 346 

17 

CPU instruction 

17 765 360 

20 

CPU instruction 

17 765 374 

20 

CPU instruction 

17 765 450 

21 

Kernel PAR 

17 765 474 

22 

Kernel PDR 

17 765 510 

23 

JSR 

17 765 520 

23 

JSR 

17 765 530 

23 

RTS 

17 765 542 

23 

RTI 

17 765 550 

23 

IMP 

17 765 742 

25 

Main memory data compare error 

17 765 760 

25 

Main memory data compare error 

17 776 000 

25 

Main memory parity error; 
no recovery possible from this error 

17 773 644 

26 

Cache memory data compare error 

17 773 654 

26 

Cache memory no hit, recoverable 

17 773 736 

27 

Cache memory data compare error 

17 773 746 

27 

Cache memory no hit, recoverable 

17 773 764 

25/26 

Cache memory parity error, recoverable 
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NAME 

750ops - VAX-11/750 console operations 

DESCRIPTION 

The procedures described here include the major operational sequences involved in running the UNIX Sys¬ 
tem on the VAX-11/750 system. Note that these procedures are different from those used on the VAX- 
11/780. For the VAX-11/780, see 780ops(8). The following notation is used: 

1. Special characters are enclosed in <> (e.g., <ctl> represents the “control” key, and <cr> stands for the 
“carriage return” key). 

2. Items within { }s are mandatory substitutions. 

3. Items within []s are optional. 

DAILY PROCEDURES 
Disk Boot 

There is no floppy disk drive and controller supplied with the console subsystem of the VAX-11/750, nor an 
LSl-11 microprocessor as in the VAX-11/780. Instead a TU58 tape cartridge is provided in the CPU cabinet. 
It may be used to boot the system (i.e., the bootstrap procedure can be stored in this cartridge). 

When the system is first turned on, the console prompt »> is printed. If the UNIX System has been shut 
down, but not halted (see Bringing the System Down), the operator must type <ctl>p to get into console 
mode. This also halts the CPU. 

With the system halted, any of the console commands may be executed as described below under Console 
Operation. 

To boot the stand-alone shell (sash) from the default disk drive, the operator types B<cr>. The following is 
an example of this operation as seen on the console, picking up after the <ctl>p: 

»>B<cr> 

%% 


There is a four-position switch in the front panel that selects the boot device. The boot command will boot 
from the device selected by this switch. Alternately, the boot command may have an argument that selects 
the boot device superseding the switch-selected one. 

»>B [ddcu] <cr> 
where dd is a device code from: 


Code 

Device 

DL 

RLOl/02 

DB 

RP04/05/06/07, RM03, RM80 

DD 

DECTAPE II Cartridge (TU58) 

DM 

RK06/07 


c specifies the I/O channel adapter and u is one digit identifying the device drive number. For example, 

»>B DDAO <cr> 
will boot from the TU58. 

The $$ prompt indicates that the stand-alone shell (sash) is ready to accept commands. If it is desired to 
run stand-alone/icA:(lM) (or other stand-alone functions), this is the time to do it. The commands have the 
form /stand/program where program can be any name from a limited list of the UNIX System commands 
found in the directory /stand. To perform a file system consistency check, type: 

$$ /stand/fsck /dev/rpO 

To bring up the UNIX, System the operator must type unix<cr>. The system should come up through SIN¬ 
GLE USER MODE (init s, see init(lM)). 
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This is the appropriate time to do file system backups, and/icA:(lM) should be executed if it was not exe¬ 
cuted in the stand-alone section of the boot. One must never operate the UNIX System with a defective file 
system. 

After successful completion of/scA:(lM), the operator can bring the system to multi-user operation by exe¬ 
cuting init 2. 

Bringing the System Down 

The shutdown procedure is designed to gracefully turn off all processes and bring the system back to single 
user state with all buffers flushed. To do this the operator should execute shutdown{\M). If shutdown is 
not successful, use the following sequence of commands: 

killall 

sync 

telinit 6 

fsck (optional) 

The system may then be halted by typing <ctl>p. 

System Dumps 

After a system crash, the following procedure should be used to get a system dump on tape. 

1. Mount a tape with write ring and bring it on-line. 

2. Halt the system and enter console mode with <ctl>p. 

3. Issue the following command sequence, each command followed by <cr>: 

E/G 0 {Keep typing E’s until all registers have been examined: RO thru R15) 

S 400 (Start execution at 400, i.e., dump to tape) 

4. Before returning to the UNIX, System execute the stand-alone/icA:(lM). 

INSTALLATION BOOT PROCEDURE 
Tape Boot 

If tape drive 0 is a TSl 1-type tape drive, use the first program provided below. For a TU77 tape drive, use 
the second program. Make sure the power-on-action switch in the front panel is set to ‘halt’. Type <cr> at 
the end of each input line: 

TSIl Tape Drive 

»>H 

»>I 

»>D/P 200 00008FD0 
»>D H- D05A00F3 
»>D H- 0000008F 
»>D H- 0800CA80 
»>D H- 00008FC1 
»>D H- CAO18000 
»>D H- 8FC10804 
»>D H- OOFFEOOO 
»>D H- 0015508F 
»>D H- ABB45B00 
»>D H- 02AB9502 
»>D H- 8FB0FB18 
»>D H- 986B0244 
»>D H- AB955901 
»>D H- B0FB1802 
»>D H- 6B02548F 
»>D H- 00F359F4 
»>D H- 024CC004 
»>D H- 00080000 
»>D H- 0000025C 
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»>D H- OOOOOOOE 
»>D H- OOOOCOOl 
»>D H- 02000000 

»>S 200 (Start tape load) 

00000244 06 

»>S 0 (Execute boot program loaded from tape) 

TU77 Tape Drive 

»>H 

»>I 

»>D 20000 A0008FD0 
»>D H- D05000F2 
»>D H- 3204AOOl 
»>D H- C003C08F 
»>D H- A0D40424 
»>D H- 8FD00C 
»>D H- C0800000 
»>D H- 8F320800 
»>D H- lOAOFFOO 
»>D H- C007D0 
»>D H- C039D004 
»>D H- 400 

»>S 20000 (Start tape load) 

0002002F 06 

»>S 0 (Execute boot program loaded from tape) 

From this point the loader initiates a question and answer sequence to control the remainder of the load pro¬ 
cess. 

CONSOLE OPERATION 

The following is condensed from Chapter 6 of the VAX Hardware Handbook, DEC, 1980-81. 

The following are the standard console commands. The most abbreviated form is shown in parentheses. 
<ctl>P Puts the machine in Console I/O mode and halts the processor. A halt message is printed. 

<ctl>U Deletes the current input line. 

<del> Deletes the previous character. 

(E)XAMINE {address} 

Displays 8-digit hexadecimal address and its contents. 

(D)EPOSIT (address) (data) 

Enters data to address. (Refer to VAX Hardware Handbook for EXAMINE and DEPOSIT 
qualifiers.) 

(I)NITIALIZE Initializes CPU. 

(H)ALT The HALT command is implemented on the VAX-11/750 for the sake of consistency with 

the VAX-11/780. It does not actually halt the CPU since the CPU must already be halted to 
respond to the command (see <ctl>P above). It does reset the console defaults. 

(S)TART {address} 

Initializes CPU, enters address to PC, issues CONTINUE to CPU, and puts console into Pro¬ 
gram I/O mode. 

(C)ONTINUE Allows the user to restart a halted program without altering the state of the machine. 
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FILES 

/etc/shutdown 

/stand/* 

SEE ALSO 

filesave(lM), fsck(lM), init(lM), shutdown(lM), tapeboot(8). 
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NAME 

780ops - VAX-11/780 console operations 

DESCRIPTION 

The procedures described here include the major operational sequences involved in running the UNIX Sys¬ 
tem on the VAX-11/780 system. Note that these procedures are different from those used on the VAX- 
11/750. For the VAX-11/750, see 750ops(8). The following notation is used: 

1. Special characters are enclosed in <> (e.g., <ctl> represents the “control” key, and <cr> stands for the 
“carriage return” key). 

2. Items within { }s are mandatory substitutions. 

DAILY PROCEDURES 
Disk Boot 

This procedure can be used only on a system with a floppy disk updated for use with the UNIX System. If 
the floppy disk has not been so updated, the sequences shown below under UNIX System Floppy Update 
must be performed. 

When the system is first turned on, the console prompt »> is printed. If the UNIX System has been shut 
down, but not halted (see Bringing the System Down), the operator must type <ctl>p to get into console 
mode. After the prompt, type H<cr> to halt the system. 

With the system halted, any of the console commands may be executed as described below under Console 
Operation. 

To boot the stand-alone shell (sash) from the default disk drive, the operator types B<cr>. Alternatively, 
the boot command may have an argument that selects the boot device superceding the default. For exam¬ 
ple, 

B RPO 

will boot from disk drive 0, and 
B RPl 

will boot from drive 1. 

The following is an example of this operation, starting after the <ctl>p command: 

»>H<cr> 

HALTED AT nnnnnnnn 

»>B<cr> 

CPU HALTED 

INIT SEQ DONE 

HALT INST EXECUTED 

HALTED AT nnnnnnnn 

LOAD DONE, nnnnnnnn BYTES LOADED 


The $$ prompt indicates that the stand-alone shell (sash) is ready to accept commands. If it is desired to 
run stand-alone/scA:(lM) (or other stand-alone functions), this is the time to do it. The commands have the 
form /stand/program where program can be any name from a limited list of the UNIX System commands 
found in the directory /stand. To perform a file system consistency check, type: 

$$ /stand/fsck /dev/rpO 

To bring up the UNIX System, the operator must type unix<cr>. The system should come up through SIN¬ 
GLE USER MODE (ink s, see /n/f(lM)). 

This is the appropriate time to do file system backups, and/scA:(lM) should be executed if it was not exe¬ 
cuted in the stand-alone section of the boot. One must never operate the UNIX System with a defective file 
system. 
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After successful completion of/scA:(lM), the operator can bring the system to multi-user operation by exe¬ 
cuting init 2. 

Bringing the System Down 

The shutdown procedure is designed to gracefully turn off all processes and bring the system back to single 
user state with all buffers flushed. To do this the operator should execute shutdown{\M). If shutdown is 
not successful, use the following sequence of commands: 

killall 

sync 

telinit 6 

fsck (optional) 

The system may then be halted by typing the <ctl>p and H<cr> sequence. 

System Dumps 

After a system crash, the following procedure should be used to get a system dump on tape. 

1. Mount a tape with write ring and bring it on-line. 

2. Enter console mode with <ctl>p. 

3. After the »> prompt, halt the system with H<cr>. 

4. Issue the following command sequence, each command followed by <cr>: 

E R0/N:F {Examine RO thru R15) 

E SP {Get the stack pointer for the next command) 

E/V @/N:3E {Examine virtual memory beginning at the address from the previous instruction, and 
continuing for the next 63 locations; i.e., examine the stack) 

S 400 {Start execution at 400, i.e., dump to tape) 

5. Before returning to the UNIX System, execute the stand-alone/icA:(lM). 

To read the dump tape into a file for examination by crash{lM) or any other debugging program, use dd{l). 
For example, the following will read the dump and create a file named core in the current directory: 

dd if=/dev/rmtO of=core bs=16b 

System Faults 

On occasion, the UNIBUS or its devices fail in such a manner as to flood the console with error messages 
and suspend operations on UNIBUS devices. It may be possible under these conditions to bring the system 
down gracefully from an internal point-of-view, by inhibiting UNIBUS interrupts and running a normal 
shutdown. The following sequence can be executed: 

<ctl>p 

»>H 

»>E 20006004 {Look at UBA control register) 

»>D * 1 {Clear the UBA) 

»>C {Return to UNIX) 

You should now be able to login as root and run a normal shutdown sequence. Reboot the system by nor¬ 
mal means, ensuring/icA:(lM) is performed. 

INSTALLATION BOOT PROCEDURES 
Tape Boot 

The floppy disk delivered with the VAX-11/780 does not have tape-boot capability. The user must type in a 
program to read the first record on tape drive 0. If tape drive 0 is a TEl6-type tape drive, use the first pro¬ 
gram provided below. For a TU78 tape drive, use the second program. Make sure the auto-restart switch in 
the front panel is set to the off position. Type <cr> at the end of each input line: 

TEI6 Tape Drive 

»>H 

»>U 

»>I 
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INIT SEQ DONE 

»>D 20000 20008FD0 
»>D H- D0502001 
»>D H- 3204AOOl 
»>D H- C003C08F 
»>D H- A0D40424 
»>D H- 8FD00C 
»>D H- C0800000 
»>D H- 8F320800 
»>D H- lOAOFEOO 
»>D H- C007D0 
»>D H- C039D004 
»>D H- 400 

»>S 20000 (Start tape load) 

HALT INST EXECUTED 
HALTED AT 0002002F 

»>S 0 (Execute boot program loaded from tape) 

TU78 Tape Drive 

»>H 

»>U 

»>I 

INIT SEQ DONE 

»>D 20000 20008FD0 
»>D + D450200I 
»>D + 8FD00CA0 
»>D + 80000000 
»>D + 320800C0 
»>D + A0FE008F 
»>D + C004D0I0 
»>D + 39320404 
»>D + 000400C0 

»>S 20000 (Start tape load) 

HALT INST EXECUTED 
HALTED AT 00020029 

»>S 0 (Execute boot program loaded from tape) 

Erom this point the loader initiates a question and answer sequence to control the remainder of the load pro¬ 
cess. 

Disk Boot 

The floppy disk delivered with the VAX-11/780 does not have UNIX system disk-boot capability. The user 
must type in the following program to read the first block on disk drive 0. Type <cr> at the end of each 
line. 


»>H 

»>LINK 

«<H 

«<U 

«<I 

«<D/I 11 20003800 


(Save the following sequence on the floppy) 
(The prompt should change to «<) 

Halt processor 
Unjam the SBI 
Initialize the processor 
Register initialization 
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«<D RO 0 Device type code 

«<D R1 8 NEXUS number of MBA in hex 

«<D R2 0 drive number 

«<D R3 0 drive number 

«<D R4 0 

«< D R5 8 Software boot flags 

«<D FP 0 Set "no machine check expected" 

«<S 20003000 Start rom program 

«<WAIT DONE 

«<E SP Show address of working memory +0x200 

«<L VMB.EXE/S:@ Load primary bootstrap 

«<S @ and start it 

«<<ctl>C {Exit LINK mode) 

»> 

You are now ready to boot the UNIX System. Each time it is necessary to boot (or reboot) the UNIX Sys¬ 
tem, simply follow the sequence: 

»>P<cr> {Execute the commands saved in floppy link file; the console should echo each com¬ 
mand in the file.) 

$$ unix<cr> {Load and execute /unix) 

UNIX System Floppy Update 

To update the console floppy for the UNIX system operation, one must have brought the UNIX System up 
by one of the initial-load procedures described above. The following sequence can then be executed. 

# cd /stand/conflp 

# sh update 

Update prints commentary during the update operation indicating the files that are being replaced or added. 
Einally, a new table of contents is printed and the available space is indicated. 

CONSOLE OPERATION 

The following is condensed from Chapter 14 of the VAX-11/780 Hardware Handbook, DEC, 1980. 

The following are the standard console commands. The most abbreviated form is shown in parentheses. 

<ctl>P Causes console to exit Program I/O mode (talking to the VAX-11/780 program). This 

does not halt the VAX CPU. 

<ctl>U Deletes the current input line. 

<del> Deletes the previous character. 

<ctl>C Interrupts printout. 

(HE)LP Prints ‘ ‘help’ ’ file of which this is a part. 

(E)XAMINE {address} 

Displays 8-digit hexadecimal address and its contents. See “help” file for qualifiers. 

(D)EPOSIT (address) (data) 

Enters data to address. 

(UNITIALIZE Initializes CPU. 

(U)NJAM Unjams the SBI. 

(SH)OW Displays console and CPU state. 

(H)ALT Halts execution of VAX CPU instructions. 

(S)TART (address) 

Initializes CPU, enters address to PC, issues CONTINUE to CPU, and puts console into Pro¬ 
gram I/O mode. 
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(C)ONTINUE Starts execution of VAX CPU instructions. 

(SE)T (T)ERMINAL (P)ROGRAM 

Puts console into Program I/O mode. 

@ {file} Causes the named floppy file to be printed and executed. 

WARNINGS 

Only <ctl>p can be executed from Program I/O mode. It does not stop the VAX CPU from running. Only 
HALT can be executed while the VAX CPU is running and not in Program I/O mode; therefore, the sequence 
to stop the VAX-11/780 while running the UNIX System (Program I/O mode) is: 

<ctl>p 

»>H<cr> 


FILES 

/etc/shutdown 

/stand/* 

SEE ALSO 

fllesave(lM), fsck(lM), init(lM), shutdown(lM), tapeboot(8). 
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NAME 

crash - what to do when the system crashes 

DESCRIPTION 

This entry gives at least a few clues about how to proceed if the system crashes. It can’t pretend to be com¬ 
plete. 

How to bring it back up. If the reason for the crash is not evident (see below for guidance on “evident”) 
you may want to try to dump the system if you feel up to debugging. At the moment a dump can be taken 
only on magtape. With a tape mounted and ready, stop the machine, load address 44(8) (on the PDP-11), 
400(16) (on the VAX-11/780; see 780ops(8)), and start. This should write a copy of all of core on the tape 
with an EOF mark. Be sure the ring is in, the tape is ready, and the tape is clean and new. 

In restarting after a crash, always bring up the system single-user, as specified in unixboot{%) as modified 
for your particular installation. Then perform an/icA:(lM) on all file systems which could have been in use 
at the time of the crash. If any serious file system problems are found, they should be repaired. When you 
are satisfied with the health of your disks, check and set the date if necessary, then come up multi-user. 

To even boot the UNIX System at all, three files (and the directories leading to them) must be intact. First, 
the initialization program /etc/init must be present and executable. If it is not, the CPU will loop in user 
mode at location 6(8) (PDP-11), 13(16) (VAX-11/780). For init to work correctly, /dev/console and /bin/sh 
must be present. If either does not exist, the symptom is best described as thrashing. Init will go into a 
fork/exec loop trying to create a shell with proper standard input and output. 

If you cannot get the system to boot, a runnable system must be obtained from a backup medium. The root 
file system may then be doctored as a mounted file system as described below. If there are any problems 
with the root file system, it is probably prudent to go to a backup system to avoid working on a mounted 
file system. 

Repairing disks. The first rule to keep in mind is that an addled disk should be treated gently; it shouldn’t 
be mounted unless necessary, and if it is very valuable yet in quite bad shape, perhaps it should be copied 
before trying surgery on it. This is an area where experience and informed courage count for much. 

F'scA:(lM) is adept at diagnosing and repairing file system problems. It first identifies all of the files that 
contain bad (out of range) blocks or blocks that appear in more than one file. Any such files are then 
identified by name and/ick requests permission to remove them from the file system. Files with bad blocks 
should be removed. In the case of duplicate blocks, all of the files except the most recently modified should 
be removed. The contents of the survivor should be checked after the file system is repaired to ensure that it 
contains the proper data. (Note that running fsck with the -n option will cause it to report all problems 
without attempting any repair.) 

Fsck will also report on incorrect link counts and will request permission to adjust any that are erroneous. 
In addition, it will reconnect any files or directories that are allocated but have no file system references to a 
“lostH-found” directory. Finally, if the free list is bad (out of range, missing, or duplicate blocks)/ick will, 
with the operators concurrence, construct a new one. 

Why did it crash! The UNIX System types a message on the console typewriter when it voluntarily crashes. 
Here is the current list of such messages, with enough information to provide a hope at least of the remedy. 
The message has the form “panic: ...”, possibly accompanied by other information. Left unstated in all 
cases is the possibility that hardware or software error produced the message in some unexpected way. 

blkdev 

The getblk routine was called with a nonexistent major device as argument. Definitely hardware or 
software error. 

devtab 

Null device table entry for the major device used as argument to getblk. Definitely hardware or soft¬ 
ware error. 

iinit An I/O error reading the super-block for the root file system during initialization. 
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no fs A device has disappeared from the mounted-device table. Definitely hardware or software error, 
no imt 

Like “no fs”, but produced elsewhere, 
no clock 

During initialization, neither the line nor programmable clock was found to exist. 

I/O error in swap 

An unrecoverable I/O error during a swap. Really shouldn’t be a panic, but it is hard to fix. 
out of swap space 

A program needs to be swapped out, and there is no more swap space. It has to be increased. This 
really shouldn’t be a panic, but there is no easy fix. 

trap An unexpected trap has occurred within the system. This is accompanied by three numbers: a 
“ka6”, which is the contents of the segmentation register for the area in which the system’s stack is 
kept; “aps”, which is the location where the hardware stored the program status word during the 
trap; and a ‘ ‘trap type’ ’ which encodes which trap occurred. The trap types are: 

PDP-11: 

0 bus error 

1 illegal instruction 

2 BPT/trace 

3 lOT 

4 power fail 

5 EMT 

6 recursive system call (TRAP instruction) 

7 11/70 cache parity, or programmed interrupt 

8 floating point trap 

9 segmentation violation 

VAX-11/780: 

0 reserved addressing fault 

1 illegal instruction 

2 BPT instruction trap 

3 XFC instruction trap 

4 reserved operand fault 

5 recursive system call (CHMK instruction) 

6 floating point trap 

7 software level 1 (reschedule) trap 

8 segmentation violation 

9 protection fault 

10 trace trap 

11 compatibility mode fault 

In some of these cases it is possible for octal 40 to be added into the trap type; this indicates that the proces¬ 
sor was in user mode when the trap occurred. If you wish to examine the stack after such a trap, either 
dump the system, or use the console switches to examine core; the required address mapping is described 
below. 

Interpreting dumps. All file system problems should be taken care of before attempting to look at dumps. 
The dump should be read into the file /usr/tmp/core; cp{\) will do. At this point, you should execute ps 
-el -c /usr/tmp/core and who to print the process table and the users who were on at the time of the crash. 
Additional information for the PDP-11. You should dump {adbiVf} the first 30 bytes of /usr/tmp/core. 
Starting at location 4, the registers RO, Rl, R2, R3, R4, R5, SP and KDSA6 (KISA6 for 1 l/40s) are stored. If 
the dump had to be restarted, RO will not be correct. Next, take the value of KA6 (location 22(8) in the 
dump) multiplied by 100(8) and dump 2000(8) bytes starting from there. This is the per-process data asso¬ 
ciated with the process running at the time of the crash. Relabel the addresses 140000 to 141776. R5 is C’s 
frame or display pointer. Stored at (R5) is the old R5 pointing to the previous stack frame. At (R5 )h- 2 is the 
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saved PC of the calling procedure. Trace this calling chain until you obtain an R5 value of 141756, which is 
where the user’s R5 is stored. If the chain is broken, you have to look for a plausible R5, PC pair and con¬ 
tinue from there. Each PC should be looked up in the system’s name list using adb{\) and its : command, 
to get a reverse calling order. In most cases this procedure will give an idea of what is wrong. A more 
complete discussion of system debugging is impossible. 

SEE ALSO 

adb(l), fsck(lM), 780ops(8), unixboot(8). 
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NAME 

crash - what to do when the system crashes 

DESCRIPTION 

This entry gives at least a few clues about how to proceed if the system crashes. It can’t pretend to be com¬ 
plete. 

How to bring it back up. If the UNIX System voluntarily crashed, it will take a memory dump to disk and 
attempt to reboot itself. If the system appears to be ‘ ‘hung’ ’ for unknown reasons, a memory dump should 
be taken. See 3B20ops{%) for this procedure. 

After a crash, it is imperative that the file systems be checked for consistency. Perform an/icA:(lM) on all 
file systems that were in use at the time of the crash. If any serious file system problems are found, they 
should be repaired. When you are satisfied with the health of your disks, check and set the date if neces¬ 
sary, then come up multi-user. 

If it will not boot. There are many reasons why the UNIX System might not boot, including: hardware 
problems, an improperly configured system, a corrupted boot section on disk, or a corrupted root file sys¬ 
tem. Most boot failures will cause a processor recovery message (PRM) to be displayed on the system con¬ 
sole. See prm{%) for a list of failure messages. If /dev/console or /bin/sh cannot be accessed, the system 
will just appear to “hang” without any failure message. If Iboot cannot be loaded into memory by Micro¬ 
boot (indicated by PRM’s starting with FO), suspect hardware problems or a corrupted boot section on disk. 
If the UNIX System runs and then “hangs” or “panics”, suspect an improperly configured system or a cor¬ 
rupted root file system. As a general strategy, try the following in order: boot an older system version 
and/or minimally configured, boot from the back-up root file system, boot from another disk pack or the 
secondary disk drive, have the hardware checked out. 

Repairing disks. The first rule to keep in mind is that an addled disk should be treated gently; it shouldn’t 
be mounted unless necessary, and if it is very valuable yet in quite bad shape, perhaps it should be copied 
before trying surgery on it. This is an area where experience and informed courage count for much. 

T’scA:(lM) is adept at diagnosing and repairing file system problems. It first identifies all of the files that 
contain bad (out of range) blocks or blocks that appear in more than one file. Any such files are then 
identified by name wAfsck requests permission to remove them from the file system. Files with bad blocks 
should be removed. In the case of duplicate blocks, all of the files except the most recently modified should 
be removed. The contents of the survivor should be checked after the file system is repaired to ensure that it 
contains the proper data. (Note that running fsck with the -n option will cause it to report all problems 
without attempting any repair.) 

Fsck will also report on incorrect link counts and will request permission to adjust any that are erroneous. 
In addition, it will reconnect any files or directories that are allocated but have no file system references to a 
“lostH-found” directory. Finally, if the free list is bad (out of range, missing, or duplicate blocks)/ick will, 
with the operators concurrence, construct a new one. 

Why did it crashl All messages printed by the UNIX System are saved in a circular buffer contained in 
memory starting at the symbol putbuf. These messages can be looked at by examining the memory dump 
using crash{\M). 

UNIX prints a message of the form “panic: ...” when it voluntarily crashes. Here is an incomplete list of 
such messages. 

cannot mount root 

An I/O error occurred while trying to mount the root file system. Most likely caused by an improp¬ 
erly configured system. 

cannot allocate system buffers 

Too many ‘ ‘buffers’ ’ have been configured into the system. 

cannot allocate character buffers 

Too many ‘ ‘clists’ ’ have been configured into the system. 
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i/o error in swap 

A hardware error occurred while swapping a process. 

trap An unexpected hardware trap has occurred. This message is accompanied by the physical page 
addresses of the UAREA of the last running process, the interrupt stack pointer, the program counter, 
the processor status word, and a short message describing the type of trap: 

Protection violation - an attempt to access memory in a way that is not permitted, e.g. writ¬ 
ing a read-only segment. 

Segmentation violation - an attempt to access memory not within the kernel’s address 
space. 

Addressing Alignment Error - an attempt to access a data object at an improper boundary, 
e.g. a word at an odd address. 

Other “panics” are possible but in almost all cases indicate hardware problems or that the UNIX System 
has been tampered with. 

SEE ALSO 

crash(lM), fsck(lM), 3B20ops(8), 3B20boot(8), prm(8). 
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NAME 

diskboot - disk bootstrap programs 

DESCRIPTION 

There are several programs available to accomplish bootstraps off of a variety of disks. These programs 
reside in the directory /stand. 

The program must be located in block 0 of the disk pack. The space available for the program is thus only 
one block (256 words) which severely constrains the amount of error handling. Block 0 is unused by the 
UNIX file system, so this does not affect normal file system operation. To boot, the program must be read 
into memory starting at address 0 and started at address 0. This may be accomplished by standard DEC 
ROM bootstraps, special ROM bootstraps, or manual procedures. 

After initial load, the program relocates itself to high core as specified when assembled (typically 24K 
words, maximum of 28K). Next, memory below the program is cleared and the prompt # is typed on the 
console. A one digit field specifying the disk drive is expected. For example, 2 would correspond to drive 
2, starting at cylinder 0. The last word in the boot block contains a cylinder offset, initially zero, which 
may be changed to access another section of the disk pack. No error checking is done on this field; invalid 
data will cause unpredictable results. Also, there is no error checking on disk reads. 

After the file system select, the program prompts with =. The user must then enter the UNIX System path 
name of the desired file. The # character will erase the last character typed, the @ character will kill the 
entire line, and A through Z is translated to a through z. Also, carriage return (CR) is mapped into line-feed 
(LF) on input, and LF is output as CR-LF. The upper-case to lower-case conversion is used to handle 
upper-case-only terminals such as the TELETYPE nh 

Terminal Model 33 or the DEC LA30. Therefore, a file name with upper case characters cannot be booted 
using this procedure. 

After the name has been completely entered by typing CR or LF, the program searches the file system 
specified for the path name. Note, the path name may be any valid UNIX System file path name. If the file 
does not exist, or if the file is a directory or special file, the bootstrap starts over and prompts with #. Other¬ 
wise, the file is read into memory starting at address 0. If address 0 contains 000 407, a UNIX System a.out 
program is assumed and the first 8 words are stripped off by relocating the loaded program toward address 
0. Finally, a jump to address 0 is done by executing jsr pc,*$0. 

EILES 

/usr/src/stand source directory 
SEE ALSO 

a.out(4), fs(4), tapeboot(8), unixboot(8). 
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NAME 

eai - 3B20S emergency action interface 

DESCRIPTION 

The functions of the 3B20S Emergency Action Interface (EAI) on the system console are described below. 
Eunction Keys 

Four special function keys, labeled EA DISP, NORM DISP, CMD/MSG and ALM RLS are on the keyboard of 
the system console: 

EA DISP This key starts the emergency action mode and causes the EAI display, consisting of status 
indicators and a menu of commands, to appear on the top half of the screen. Status indica¬ 
tors are updated every two seconds or as changes occur. If the UNIX System is running, then 
the bottom half of the screen may be used as a login terminal and will scroll without affect¬ 
ing the EAI display. If the EAI display is already present, then depressing this key will cause 
the screen to be updated. 

NORM DISP This key ends the EAI mode, erases the EAI display and leaves the screen blank. The full 
screen is now available as a UNIX System login terminal. 

CMD/MSG This key toggles the cursor between the command entry area and the UNIX System portion 
(bottom half message section) of the screen. EAI commands can be entered only when the 
cursor is in the command entry position (next to CMD:). This key is effective only when the 
screen is in EAI mode. 

This key currently performs no function. 

A single digit incremented once every two seconds that indicates the ability of the Mainte¬ 
nance TTY Peripheral Controller (MTTYPC) to update the EAI display. 

A series of five indicators describing the current state of the 3B20S processor as seen by the 
EAI. 

ACT The 3B20S processor is on-line (it has I/O access). 

RUN The 3B20S is processing instructions (not stopped or halted). 

EONL The 3B20S is forced to be the on-line processor (I/O is allowed) and the Diagnos¬ 
tic Processor (DP) cannot gain I/O access. 

POPE The 3B20S is forced to be the off-line processor (I/O is inhibited) and cannot gain 
I/O access. 

RCVRY 3B20S microcode has signaled the start of processor recovery. 

A series of five indicators describing the current state of the DP as seen by DP microcode. 
These are the same as the indicators for 3BCC above, with the role of the 3B20S and the DP 
interchanged. 

currently unused. 

A single indicator with three possible states describing the state of the link between the EAI 
and the MTTYPC. 

ASW All Seems Well. 

ERR The EAI can communicate with the MTTYPC but there are problems. 

OOS The EAI is unable to communicate with the MTTYPC. 

DPI Same as EAI, but indicates the state of the link between the DP and the MTTYPC. 

TIMEOUT This appears only if the EAI has not received a low priority Processor Recovery Message 

(PRM) within a seventy second time period. This is an indication of lack of sanity of the 
3B20S processor. 


DPCC 

sees 

EAI 


ALM RLS 

Status Indicators 
MTTY 

3BCC 
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3BPRM Processor Recovery Message (PRM) from the 3B20S processor. 

DPPRM PRM from the Diagnostic Processor. 

Commands 

Commands can be entered only when the cursor is positioned in the top left-hand corner of the screen next 
to CMD:. A command is entered by keying in the number associated with the command by the EAI display 
menu. Commands may be terminated either by a carriage return or by an exclamation point (!). A charac¬ 
ter may be erased by a backspace or an underscore. A line may be killed with a dollar sign ($). When a 
line is entered, the EAI responds with OK for a successfully entered command, or NG for an invalid com¬ 
mand. 


Commands 60-65 cause immediate action when they are entered. Commands 60-62 refer to the Diagnos¬ 
tic Processor (DP), which will be supplied in the future as an option. 


60 3B-FONL Forces the 3B20S processor on-line, allowing the 3B20S processor I/O access and inhibit¬ 

ing the DP I/O access. Any diagnostics that were running on the DP are aborted. 

61 DP-FONL Forces the 3B20S processor off-line, inhibiting the 3B20S processor I/O access and 

allowing the DP I/O access. If the UNIX System was running on the 3B20S, then it is 
aborted. The DP executes lOP diagnostics, reads a diagnostic tape and then establishes an 
interface to the MTTYPC in order to accept diagnostic commands. 


62 DP-INIT 

63 CFT-INIT 

64 PRM-DUMP 

65 CLR-EAI 


Initializes the DP. 

Currently not implemented. 

Currently not implemented. 

Resets all functions on the EAI display and zeroes the 3BPRM and DPPRM helds. All 
SET/CLR functions are reset to CLR. 


Commands 70-73 and 76-93 set or clear options to be used during and after the next initialization, disk 
boot, disk dump or load from tape. They cause no immediate action. Commands 74 and 75 affect only the 
EAI display and not the UNIX System software. In each pair below, the even number sets the option and is 
displayed as SET, and the odd number clears the option and is displayed as CLR. The description below 
represents the option that is selected when the even command of the pair is entered. Unless explicitly noted 
otherwise, the corresponding odd command undoes this option. 

70-71 SEC-DISK 

Causes moving head disk 1 on disk hie controller 0 to be used as the boot device or the 
disk to be loaded by LDTAPE (see 98 below). Clearing this option causes moving head 
disk 0 on disk hie controller 0 to be used. 


72-73 INH-TIMER 

Inhibits automatic recovery when a sanity timeout occurs. 

74-75 PRM-TRAP 

Freezes the next failing PRM on the EAI display. 

76-77 PARAMETER 

Sets a parameter which is used to determine the action taken by INIT (see 95 below) or by 
automatic recovery after a failure. When the 76 command is entered, the user is 
prompted for a single character parameter value on the command entry line in the EAI 
display. After the character is entered, it will be displayed next to the word PARAMETER 
on the display. Possible values for the parameter are: 

h causes the system to idle. 

H causes the system to halt. The system will reboot if the sanity timer is not inhibited, 
d causes the system to dump a memory image to disk and then reboot. 
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D causes the system to dump a memory image to disk and then idle, 
r causes the system to reboot. 

If the parameter is cleared or if it is set to a value not mentioned above, then the default 
action will be reboot the processor. 

80-81 PROMPT-UNIX 

If set, this causes the disk bootstrap program to prompt the user for the name of the pro¬ 
gram to be booted. If clear, /unix will be chosen as the program to be booted. See 
3B20boot(S). 

82-83 BACKUP-ROOT 

Causes the disk bootstrap program to hnd the program to be booted on the backup root 
file system. If clear, the normal root hie system is used (see dsk{l)). 

84-85 MIN-CONFIG 

Causes the UNIX System to bring only the boot device, the system console and a tape 
drive into service and only the hrst megabyte of main memory will be used. 

86-87 INH-HDW-CHK 

Causes the UNIX System to disable refresh and correctable main store parity error detec¬ 
tion. 

88-89 INH-SFT-CHK 

Currently unused. 

90-91 INH-ERR-INT 

Currently unused. 

92-93 INH-CACHE 

Disables the use of cache memory. 

Commands 95-99 cause immediate action which is affected by options 70-73 and 76-93 above. If these 
commands fail, they will output PRMs in the 3BPRM held of the display. An explanation of failure PRMs is 
found in prm{%). 


95 INIT 

Causes different action depending on the parameter value set by command 76. 

96 BOOT 

Causes a disk bootstrap. See 3B20boot{%). 

97 DUMP 

Causes a memory image of the operating system to be dumped to disk followed by a disk 
bootstrap. 

98 LDTAPE 

Causes a disk to be loaded from tape. See ldtape{%). 

99 HALT 

Causes the UNIX System to idle. 

SEE ALSO 



dsk(7), 3B20boot(8), ldtape(8), prm(8). 
UNIX System Operator’s Guide. 
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NAME 

diskboot - disk bootstrap programs 

DESCRIPTION 

There are several programs available to accomplish bootstraps off of a variety of disks. These programs 
reside in the directory /stand. 

The program must be located in block 0 of the disk pack. The space available for the program is thus only 
one block (256 words) which severely constrains the amount of error handling. Block 0 is unused by the 
UNIX file system, so this does not affect normal file system operation. To boot, the program must be read 
into memory starting at address 0 and started at address 0. This may be accomplished by standard DEC 
ROM bootstraps, special ROM bootstraps, or manual procedures. 

After initial load, the program relocates itself to high core as specified when assembled (typically 24K 
words, maximum of 28K). Next, memory below the program is cleared and the prompt # is typed on the 
console. A one digit field specifying the disk drive is expected. For example, 2 would correspond to drive 
2, starting at cylinder 0. The last word in the boot block contains a cylinder offset, initially zero, which 
may be changed to access another section of the disk pack. No error checking is done on this field; invalid 
data will cause unpredictable results. Also, there is no error checking on disk reads. 

After the file system select, the program prompts with =. The user must then enter the UNIX System path 
name of the desired file. The # character will erase the last character typed, the @ character will kill the 
entire line, and A through Z is translated to a through z. Also, carriage return (CR) is mapped into line-feed 
(LF) on input, and LF is output as CR-LF. The upper-case to lower-case conversion is used to handle 
upper-case-only terminals such as the TELETYPE nh 

Terminal Model 33 or the DEC LA30. Therefore, a file name with upper case characters cannot be booted 
using this procedure. 

After the name has been completely entered by typing CR or LF, the program searches the file system 
specified for the path name. Note, the path name may be any valid UNIX System file path name. If the file 
does not exist, or if the file is a directory or special file, the bootstrap starts over and prompts with #. Other¬ 
wise, the file is read into memory starting at address 0. If address 0 contains 000 407, a UNIX a.out pro¬ 
gram is assumed and the first 8 words are stripped off by relocating the loaded program toward address 0. 
Finally, a jump to address 0 is done by executing jsr pc,*$0. 

EILES 

/usr/src/stand source directory 
SEE ALSO 

a.out(4), fs(4), tapeboot(8), unixboot(8). 
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NAME 

Idtape - load disk from tape procedures 

DESCRIPTION 

Ldft is a program loaded from tape into memory and executed in response to the LDTAPE command on the 
EAI page of the console. (See eai{%) and Setting up the UNIX System in the UNIX System Administrator’s 
Guide for further details on the use of the console and setting up the UNIX System.) Ldft is intended for use 
only to create a disk pack in a proper format when a new release of the UNIX System is installed. 

To run ldft, mount the disk pack that is to be loaded on moving head disk drive 0 or 1, mount LDFT tape 
number 0 on tape drive unit 0, and issue the LDTAPE command on the EAI page at the console. 

Ldft will look at the SEC-DISK flag and the PARAMETER held on the EAI when the LDTAPE command is 
issued. The disk to be loaded is specified by the SEC-DISK flag. Moving head disk 0 is used if the flag is 
clear. Moving head disk 1 is used if the flag is set. 

If the PARAMETER held contains an f or an F, ldft will format the disk in the specified drive before contin¬ 
uing. (The format should be done unless it is known that the disk pack has already been formatted.) 

Ldft will then rewind the tape and issue a success Processor Recovery Message (PRM) asking for LDFT tape 
number 1 to be mounted. (See the diagnostics section below.) Mount the next tape and issue another 
LDTAPE command. Ldft will read the tape copying data to disk as it is read. When the end of tape is 
found, ldft will rewind the tape. If another LDFT tape is expected, ldft will issue a success PRM requesting 
the next tape. When the last LDFT tape has been read, ldft will issue a success PRM similar to a request for 
the next tape with the tape number held containing BBBB. When this point is reached, the disk has been 
loaded and can be booted. See 3B20boot{%) for boot procedures. 

SEE ALSO 

3B20boot(8), eai(8), prm(8). 

Setting up the UNIX System in the UNIX System Administrator’s Guide. 

DIAGNOSTICS 

The following code words are used in success PRM’s from ldft: 

Code Meaning 

cyls 50 cylinder disk section number 

sect Tape section number 

tape Tape reel number 


The following success PRM’s are generated by ldft: 

PRM 


Meaning 

ElOO 7000 0000 

0000 

lOP, tape, and DFC in service 

ElOO 7100 tape 

0000 

Request to mount tape 

ElOO 7500 sect 

tape 

Section header read successfully 

EEOO 0000 cyls 

0000 

Starting disk section format 

Failure PRM’s are listed in prm{%). 



Page 1 



MK(8) 


MK(8) 


NAME 

mk - how to remake the system and commands 

DESCRIPTION 

All source for the UNIX System is in a source tree distributed in the directory /usr/src. This includes 
source for the operating system, libraries, commands, miscellaneous files necessary to the running system, 
and procedures to create everything from this source. 

The top level consists of the directories cmd, lib, uts, head, and stand as well as commands to remake 
each of these “directories”. These commands are named :mk, which remakes everything, and .mkdir 
where dir is the directory to be recreated. Each recreation command will make all or part of the piece; over 
which it has control. :mk will run each of these commands and thus recreate the whole system. 

The lib directory contains libraries used when loading user programs. The largest and most important of 
these is the C library. All libraries are in sub-directories and are created by a makefile or runcom. A run- 
com is a Shell command procedure used specifically to remake a piece of the system. :mklib will rebuild 
the libraries that are given as arguments. The argument \* will cause it to remake all libraries. 

The head directory contains the header files, usually found in /usr/include on the running system. 
:mkhead will install those header files that are given as arguments. The argument \* will cause it to install 
all header files. 

The uts directory contains the source for the UNIX operating system. :mkuts (no arguments) invokes a 
series of makefiles that will recreate the operating system. 

The stand directory contains stand-alone commands and boot programs. :mkstand will rebuild and install 
these programs. 

The cmd directory contains files and directories. :mkcmd transforms source into a command based upon its 
suffix ( 1, .y, .c, .s, .sh), or its makefile (see make{l)) or runcom. A directory is assumed to have a makefile 
or a runcom that will take care of creating everything associated with that directory and its sub-directories. 
Makefiles and runcoms are named command mk and command.rc respectively. 

:mkcmd will recreate commands based upon a makefile or runcom if one of them exists; alternatively com¬ 
mands are recreated in a standard way based on the suffix of the source file. All commands requiring more 
than one file of source are grouped in sub-directories, and must have a makefile or a runcom. C programs 
(.c) are compiled by the C compiler and loaded stripped with shared text. Assembly language programs (.s) 
are assembled with /usr/include/sys.s which contains the system call definitions. Yacc programs (.y) and 
lex programs (.1) are processed by yacc{\) and lex{\) respectively before C compilation. Shell programs 
(.sh) are copied to create the command. Each of these operations leaves a command in ./cmd which is then 
installed by using /etc/install. 

The arguments to :mkcmd are either command names, or subsystem names. The subsystems distributed 
with the UNIX System are; acct, graf, rje, sees, and text. Prefacing the :mkcmd instruction with an assign¬ 
ment to the Shell variable $ARGS will cause the indicated components of the subsystem to be rebuilt. 

The entire sees subsystem can be rebuilt by: 

/usr/src/:mkcmd sees 

while the delta component of sees can be rebuilt by: 

ARGS="delta" /usr/src/;mkcmd sees 

The log command, which is a part of the stat package, which is itself a part of the graf package, can be 
rebuilt by: 

ARGS="stat log" /usr/src/:mkcmd graf 
The argument \* will cause all commands and subsystems to be rebuilt. 

Makefiles, both in ./cmd and in sub-directories, have a standard format. In particular :mkcmd depends on 
there being entries for install and clobber. Install should cause everything over which the makefile has 
jurisdiction to be made and installed by /etc/install. Clobber should cause a complete cleanup of all 
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unnecessary files resulting from the previous invocation. 

Most of the runcoms in ./cmd (as opposed to sub-directories) relate in particular to a need for separated 
instruction and data (I and D) space. 

In the past, dependency on the C library routine ctime{3C) was also important. Ctime had to be modified 
for all systems located outside of the eastern time zone, and all commands that referenced it had to be 
recompiled. Ctime has been rewritten to check the environment (see environiS)) for the time zone. This 
results in time zone conversions possible on a per-process basis, /etc/profile sets the initial environment for 
each user, and /etc/rc sets it for certain system daemons. These two programs are the only ones which must 
be modified outside of the eastern time zone. 

An effort has been made to separate the creation of a command from source, and its installation on the run¬ 
ning system. The command /etc/install is used by :mkcmd and most makefiles to install commands in the 
proper place on the running system. The use of install allows maximum flexibility in the administration of 
the system. Install makes very few assumptions about where a command is located, who owns it, and what 
modes are in effect. All assumptions may be overridden on invocation of the command, or more perma¬ 
nently by redefining a few variables in install. The object is to install a new version of a command in the 
same place, with the same attributes as the prior version. 

In addition, the use of a separate command to perform installation allows for the creation of test systems in 
other than standard places, easy movement of commands to balance load, and independent maintenance of 
makefiles. The minimization of makefiles in most cases, and the site independence of the others should 
greatly reduce the necessary maintenance, and allow makefiles to be considered part of the standard source. 

SEE ALSO 

install(lM), make(l). 
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NAME 

prm - 3B20S Processor Recovery Messages 

DESCRIPTION 

This manual page describes the Processor Recovery Messages (PRM’s) produced by the 3B20S processor. 


SEE ALSO 

3B20boot(8), eai(8), ldtape(8). 


DIAGNOSTICS 

These code words appear in the following list of PRM’s: 


Code Meaning 

cc DFC job completion code 

dcod 3/6 code for disk device 

dfca High order 16 bits of DFC 2nd status word 
dmpct Number of failed tries necessary to get a dump 

dopcnt DFC operation count for this stage 

flag Root or backup root filesystem flag 

g DFC Firmware Generic number 

resp lOP command completion response 

OOFF - interrupt timed out 
s DFC processing stage: 

1 - Firmware Generic determination 

2 - Sysgen DFC 

3 - Bring DFC in service 

4 - Bring Disk in service 

5 - Re ad/write the Disk 

6 - Format the Disk 

sect Tape section number 

stat Channel status 

tape Tape reel number 

tcod 3/6 code for tape device 


Non-error PRM’s: 

PRM 

EOOO 0000 0000 0000 
EOOO 0100 0000 0000 
EOOO 0200 0000 0000 
EOOO 0300 0000 0000 
EOOO 0400 0000 0000 
EOOO 0500 0000 0000 
EOOO 0600 0000 0000 
EOOO 0000 0070 dmpct 


Meaning 
MRF entered 

MRF successfully exited to PINIT 
MRF successfully exited to STOP & SWITCH 
Successful exit from microboot 
MRF exited to POWER CLEAR halt 
Pump successfully exited to PINIT 
Successful exit from tapeboot ucode 
Completed dump 


Failure PRM’s: 




PRM 


Meaning 

EOOO 

0800 

0000 

0000 

Microboot-lboot job-channel init failed 

EOOO 

0900 

0000 

0000 

Microboot-vtoc job-dma setup failed 

EOOO 

OAOO 

0000 

0000 

Microboot-vtoc job-bic init failed 

EOOO 

OBOO 

0000 

0000 

Microboot-vtoc job-pic init failed 

EOOO 

OCOO 

0000 

0000 

Microboot-vtoc job-boot command failed 

EOOO 

ODOO 

0000 

0000 

Microboot-vtoc job-disk job timed out 

EOOO 

OEOO 

0000 

0000 

Microboot-vtoc job-disk job error 
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FOOD 

1000 

0000 

0000 

Microboot-ucode pump-channel init failed 

FOOD 

1100 

0000 

0000 

Microboot-ucode pump-dma setup failed 

FOOD 

1200 

0000 

0000 

Microboot-ucode pump-bic init failed 

FOOD 

1300 

0000 

0000 

Microboot-ucode pump-pic init failed 

FOOD 

1400 

0000 

0000 

Microboot-ucode pump-boot command failed 

FOOD 

1500 

0000 

0000 

Microboot-ucode pump-disk job timed out 

FOOD 

1600 

0000 

0000 

Microboot-ucode pump-disk job error 

FOOD 

1700 

0000 

0000 

Microboot-ucode pump-error in ucode file 

FOOD 

1800 

0000 

0000 

Microboot-lboot job-channel init failed 

FOOD 

1900 

0000 

0000 

Microboot-lboot job-dma setup failed 

FOOD 

lAOO 

0000 

0000 

Microboot-lboot job-bic init failed 

FOOD 

IBOO 

0000 

0000 

Microboot-lboot job-pic init failed 

FOOD 

ICOO 

0000 

0000 

Microboot-lboot job-boot command failed 

FOOD 

IDOO 

0000 

0000 

Microboot-lboot job-disk job timed out 

FOOD 

lEOO 

0000 

0000 

Microboot-lboot job-disk job error 

FOOD 

2100 

0000 

0000 

LDFT-channel or bic init failed 

FOOD 

2200 

0000 

0000 

LDFT-pic init failed 

FOOD 

2300 

0000 

0000 

LDFT-dma setup for tape failed 

FOOD 

2400 

0000 

0000 

LDFT-quick sysgen for tape failed 

FOOD 

2500 

0000 

0000 

LDFT-tape rewind failed 

FOOD 

2600 

0000 

0000 

LDFT-tape read of ucode header failed 

FOOD 

2700 

0000 

0000 

LDFT-bad ucode header 

FOOD 

2800 

0000 

0000 

LDFT-tape read of ucode failed 

FOOD 

2900 

0000 

0000 

LDFT-invalid ucode file 

FOOD 

2A00 

0000 

0000 

LDFT-tape read of LDFT header failed 

FOOD 

2B00 

0000 

0000 

LDFT-invalid LDFT header 

FOOD 

2C00 

0000 

0000 

LDFT-tape read of LDFT failed 

FOOD 

2D00 

0000 

0000 

LDFT-bic init for disk failed 

FOOD 

2E00 

0000 

0000 

LDFT-pic init for disk failed 

FIDO 

0100 

0000 

stat 

Can’t initialize DMAC 

FIDO 

0200 

0000 

stat 

Can’t initialize DSCH 

FIDO 

0300 

0000 

stat 

Can’t enable DMA access to MAS 

FIDO 

1000 

0000 

stat 

Can’t write DMAC ram 

FIDO 

1100 

0000 

0000 

Can’t clear DBS 

FIDO 

1200 

0000 

stat 

Can’t initialize BIC 

FIDO 

1300 

0000 

stat 

Can’t enable BIC/PIC interface 

FIDO 

1400 

0000 

stat 

Can’t enable BIC interrupts 

FIDO 

15gs 

dopcnt 

stat 

Can’t send GIDPIO to DFC 

FIDO 

16gs 

dopant 

stat 

Can’t sysgen the DFC 

FIDO 

17gs 

dopcnt 

stat 

Can’t bring the DFC into service 

FIDO 

20gs 

dopcnt 

stat 

Can’t bring the disk into service 

FIDO 

31gs 

dopcnt 

stat 

Can’t read DFC status (read/write) 

FIDO 

32gs 

dopcnt 

stat 

Can’t read DFC status (format) 

FIDO 

33gs 

dopcnt 

0000 

Invalid DFC software parameters 

FIDO 

34gs 

dopcnt 

stat 

Can’t wakeup DFC 

FIDO 

40g s 

dopcnt 

stat 

Can’t reset BIC interrupt 
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FIDO 41gs 

dopcnt 

stat 

Can’t send status command to DFC 

FIDO 42gs 

dopcnt 

stat 

Can’t read 1st DFC status word 

FIDO 43gs 

dopcnt 

stat 

Can’t read 2nd DFC status word 

FlOO 44gs 

cc 

dfca 

Bad DFC response 

FIDO 45gs 

dopcnt 

stat 

Can’t enable BIC interrupt 

FlOO 4(>gs 

dopcnt 

0000 

DFC interrupt timed out 

FlOO 5000 

0000 

stat 

Can’t write DMAC ram 

FlOO 5001 

0000 

stat 

Can’t clear DDES 

FlOO 5002 

0000 

stat 

Can’t send BIC command 

FlOO 5003 

0000 

stat 

Can’t send BIC command 

FlOO 5004 

0000 

stat 

Can’t enable lOP interrupts 

FlOO 5005 

0000 

stat 

Can’t send lOP sysgen 

FlOO 5006 

0000 

0000 

lOP sysgen failed 

FlOO 5011 

0000 

stat 

Can’t sense DDES status 

FlOO 5012 

0000 

stat 

DDES status error 

FlOO 5013 

0000 

stat 

Can’t reset BIC interrupt 

FlOO 5020 

0000 

stat 

Can’t sense BIC status 

FlOO 5021 

0000 

stat 

Can’t sense BIC status 

FlOO 5022 

0000 

stat 

BIC status error 

FlOO 5023 

0000 

stat 

Can’t send PIC command 

FlOO 5030 

0000 

resp 

Tape read failed 

FlOO 5040 

0000 

resp 

Tape rewind failed 

FlOO 5060 

0000 

resp 

PC community configure failed 

FlOO 5061 

0000 

resp 

Clear PC micro failed 

FlOO 5062 

0000 

resp 

Console failed to come into service 

FlOO 5063 

0000 

resp 

Console pump failed 

FlOO 5064 

0000 

resp 

Console exec failed 

FlOO 5065 

0000 

resp 

Console restore failed 

FlOO 5066 

0000 

resp 

Console connect failed 

FlOO 5070 

0000 

resp 

Console I/O failed 

FlOO 5080 

0000 

resp 

PC community failed to come into service 

FlOO 5081 

0000 

resp 

Clear PC micro failed 

FlOO 5082 

0000 

resp 

Tape PC failed to come into service 

FlOO 7200 

tcod 

0000 

Bad 3/6 code for tape from microboot 

FlOO 7300 

dcod 

0000 

Bad 3/6 code for disk from microboot 

FlOO 7400 

sect 

tape 

Bad tape section header 

FlOO 8000 

0000 

flag 

VTOC has no entry for filesystem 

FlOO COOO 

0000 

0000 

File size too big 

0000 dmpct 

DDDD 

0002 

Dump can’t initialize DSCH 

0000 dmpct 

DDDD 

0003 

Dump can’t initialize DMA 

0000 dmpct 

DDDD 

0005 

Dump can’t enable DMA interupts 

0000 dmpct 

DDDD 

0006 

Dump can’t load DMAC ram 

0000 dmpct 

DDDD 

0007 

Dump can’t clear dual bus selector 

0000 dmpct 

DDDD 

0008 

Dump can’t initialize BIC 

0000 dmpct 

DDDD 

0009 

Dump can’t enable BIC interface 

0000 dmpct 

DDDD 

0010 

Dump can’t enable device interupts 
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0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 
0000 dmpct 


DDDD 0011 
DDDD 0012 
DDDD 0013 
DDDD 0014 
DDDD 0015 
DDDD 0016 
DDDD 0017 
DDDD 0018 
DDDD 0019 
DDDD 0020 
DDDD 0021 
DDDD 0022 


Dump can’t send GIDPIO to DFC 
Dump can’t sysgen the DFC 
Dump can’t bring DFC into service 
Dump can’t bring disk into service 
Dump can’t reset BIC interupts 
Dump can’t get job states 
Dump can’t job completion word 
Dump can’t get job error word 
Dump DFC job failed 
Dump can’t enable BIC interupts 
Dump can’t send job pending command 
Dump DFC interrupt timed out 


F200 DEAD DEAD DEAD Panic in UNIX 

F300 FFFF FFFF FFFF UNIX System can’t execute/etc/init 
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NAME 

ije - RJE (Remote Job Entry) to IBM 

SYNOPSIS 

/usr/rje/rjeinit 

/usr/rje/rjehalt 

DESCRIPTION 

RJE is the communal name for a collection of programs and a file organization that allows a UNIX System, 
equipped with the appropriate hardware and associated Virtual Protocol Machine (VPM) software, to com¬ 
municate with IBM’s Job Entry Subsystems by mimicking an IBM 360 remote multileaving work station. 

Implementation. 

RJE is initiated by the command rjeinit and is terminated gracefully by the command rjehalt. While active, 
RJE runs in the background and requires no human supervision. It quietly transmits, to the IBM system, 
jobs that have been queued by the send{\C) command, and operator requests that have been entered by the 
rjestat (1C) command. It receives, from the IBM system, print and punch data sets and message output. It 
enters the data sets into the proper UNIX System directory and notifies the appropriate user of their arrival. 
It scans the message output to maintain a record on each of its jobs. It also makes these messages available 
for public inspection, so that rjestat(lC), in particular, may extract responses. 

Unless otherwise specified, all files and commands described below reside in directory /usr/rje (first excep¬ 
tions: send and rjestat). 

There are two sources of data to be transmitted by RJE from the UNIX System to an IBM System/370. In 
both cases, the data is organized as files in the /usr/rje/squeue directory. The first are files named co* 
which are created by the enquiry command rjestat(lC). The second source, containing the bulk of the data, 
are files named rd* or sq* which have been created by send and queued by the program rjeqer. On com¬ 
pletion of processing send invokes rjeqer. Rjeqer and rjestat inform the program rjexmit that a file has 
been queued via the file joblog. Upon successful transmission of the data to the IBM machine, rjexmit 
removes the queued file. As files are transmitted and received, the program rjedisp writes an entry contain¬ 
ing the date, time, file name, logname, and number of records in the file acctlog, if it exists. This file can be 
used for local logging or accounting information, but is not used elsewhere by RJE. The use of this infor¬ 
mation is up to the RJE administrator. 

Each time rjeinit is invoked, the joblog file is truncated and recreated from the contents of the 
/usr/rje/squeue directory. During this time, rjeinit prevents simultaneous updating of the joblog file. 

Output from the IBM system is classified as either a print data set, a punch data set, or message output. 
Print output is converted to an ASCII text file, with standard tabs. Eorm feeds are suppressed, but the last 
line of each page is distinguished by the presence of an extraneous trailing space. Punch output is con¬ 
verted to pnch(4) format. This classification and both conversions occur as the output is received. Piles are 
moved or copied into the appropriate user’s directory and assigned the name prut* or pnch*, respectively, 
or placed into user directories under user-specified names, or used as input to programs to be automatically 
executed, as specified by the user. This process is driven by the “usr=...” specification. RJE retains owner¬ 
ship of these files and permits read-only access to them. Message output is digested by RJE immediately 
and is not retained. 

A record is maintained for each job that passes through RJE. Identifying information is extracted contextu¬ 
ally from files transmitted to and received from the IBM system. This information is stored and used by the 
rjedisp program for IBM job acknowledgements and delivery of output files. 

The IBM system automatically returns an acknowledgement message for each job it receives. Other status 
messages are returned in response to enquiries entered by users. All messages received by RJE are 
appended to the resp file. The resp file is automatically truncated when it reaches 70,000 bytes. Each 
enquiry is preceded and followed by an identification card image of the form “%\]X<process id>”. The 
IBM system will echo this back as an illegal command. The appearance of process ids in the response 
stream permits responses to be passed on to the proper users. 
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While it is active, RJE occupies at least the three process slots that are appropriated by rjeinit. These slots 
are used to run rjexmit, the transmitter, rjerecv, the receiver, and rjedisp, the dispatcher. These three pro¬ 
cesses are connected by pipes. The function of each is as follows: 

rjexmit Cycles repetitively, looking for data to transmit to the IBM system. After transmission, rjexmit 
passes an event notice to rjedisp. If rjexmit encounters a stop file, (created by rjehalt), it exits 
normally. In the case of error termination, rjexmit reboots RJE by executing rjeinit. 

rjerecv Cycles repetitively, looking for data returning from the IBM machine. Upon receipt of data, 
rjerecv notifies either rjexmit or rjedisp of the event (transfer information is sometimes passed to 
rjexmit). Rjerecv exits normally at the first appropriate moment when it encounters the file stop, 
or exits reluctantly when it encounters a run of errors. 

rjedisp Follows up event notices by directing output files, updating records, and notifying users. Rjedisp 
references the system files /etc/passwd and /etc/utmp to correlate user names, numeric ids, and 
terminals. Termination of rjerecv causes rjedisp to exit also. 

Rjeinit has the capability of dialing any remote IBM system with the proper hardware and software 
configuration. 

Most RJE files and directories are protected from unauthorized tampering. The exception is the spool direc¬ 
tory. It is used by send{\C) to create temporary files in the correct file system. Rjeqer and rjestat{\C), the 
user’s interfaces to RJE, operate in setuid mode to contribute the necessary permission modes. 

Administration. 

Some minimal oversight of each RJE subsystem is required. The RJE mailbox should be inspected and 
cleaned out periodically. The job directory should also be checked. The only files placed there are output 
files whose destination file systems are out of space. Users should be given a short period of time (say, a 
day or two), and then these files should be removed. 

The configuration table /usr/rje/lines is accessed by all components of RJE. Each line of the table (maxi¬ 
mum of 8) defines an RJE connection. Its seven columns may be labeled host, system, directory, prefix, 
device, peripherals and parameters. These columns are described as follows: 

host The name of a remote IBM computer (e.g., A B C). This string can be up to 5 characters. 

system 

The name of a UNIX system. This name should be the same as the system name from uname{\). 

directory 

This is the directory name of the servicing RJE subsystem (e.g., /usr/rjel). 

prefix This is the string prefixed (redundantly) to several crucial files and programs in directory (e.g., 
rjel, rje2, rje3). 

device 

This is the name of the controlling VPM device, with /dev/ excised, 
peripherals 

This field contains information on the logical devices (readers, printers, punches) used by RJE. 
Each subfield is separated by :, and is described as follows: 

(1) Number of logical readers. 

(2) Number of logical printers. 

(3) Number of logical punches. 

Note: the number of peripherals specified for an RJE subsystem must agree with the number of 
peripherals which have been described on the remote machine for that line. 

parameters 

This field contains information on the type of connection to make. Each subfield is separated by :. 
Any or all fields may be omitted; however, the fields are positional. All but trailing delimiters 
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must be present. For example, in 

1200:512:::9-555-1212 

subfields 3 and 4 are missing, but the delimiters are present. Each subfield is defined as follows: 

(1) space 

This subfield specifies the amount of space (5) in blocks that RJE tries to maintain on file 
systems it touches. The default is 0 blocks. Send will not submit jobs and rjeinit issues a 
warning when less than 1.55 blocks are available; rjerecv stops accepting output from the 
host when the capacity falls to 5 blocks; RJE becomes dormant, until conditions improve. 
If the space on the file system specified by the user on the “usr=” card would be depleted 
to a point below 5, the file will be put in the job subdirectory of the connection’s home 
directory, rather than in the place that the user requested. 

(2) size This subfield specifies the size in blocks of the largest file that can be accepted from the 

host without truncation taking place. The default is no truncation. 

(3) badjobs 

This subfield specifies what to do with undeliverable returning jobs. If an output file is 
undeliverable for any reason other than file system space limitations (e.g., missing or 
invalid “usr=” card) and this subfield contains the letter y, the output will be retained in 
the job subdirectory of the home directory, and login rje is notified. If this subfield con¬ 
tains an n or has any other value, undeliverable output will be discarded. The default is n. 

(4) console 

This subfield specifies the status of the interactive status terminal for this line. If the 
subfield contains an i, all console status facilities are inhibited (e.g., rjestat{lC) will not 
behave like a status terminal). In all cases, the normal non-interactive uses of rjestat(lC) 
will continue to function. The default is y. 

(5) dial-up 

This subfield contains a telephone number to be used to call a host machine. The tele¬ 
phone number may contain the digits 0 thru 9 and the character - which denotes a pause. 
If the telephone number is not present, no dialing is attempted and a leased line is 
assumed. 

Sign-on is controlled by the existence of a signon file in the home directory. If this file is present, its con¬ 
tents are sent as a sign-on message to the host system. If this file does not exist, a blank card is sent. Sign- 
off is controlled in the same way, except that the signoff file is sent by rjehalt if it exists. If the signoff file 
does not exist, a ‘7*signoff” card is sent. These files should be ASCII text and no more than 80 characters. 

Send{\C) and rjestat(lC) select an available connection by indexing on the host field of the configuration 
table. RJE programs index on the prefix field. A subordinate directory, sque, exists in /usr/rje for use by 
rjedisp and shqer programs. This directory holds those output files that have been designated as standard 
input to some executable file. This designation is done via the “usr=...” specification. Rjedisp places the 
output files here and updates the file log to specify the order of execution, arguments to be passed, etc. 
Shqer executes the appropriate files. 

All RJE programs are shared text; therefore, if more than one RJE is to be run on a given UNIX system, sim¬ 
ply link (via In) RJE2 program names to RJE names in /usr. 

SEE ALSO 

cp(l), rjestat(lC), send(lC), pnch(4), un53(7), vpm(7), mk(8). 

UNIX System User’s Guide. 

UNIX System Remote Job Entry Administrator’s Guide in the UNIX System Administrator’s Guide. 

Setting up the UNIX System in the UNIX System Administrator’s Guide. 

DIAGNOSTICS 

Rjeinit provides brief error messages describing obstacles encountered while bringing up RJE. They can 
best be understood in the context of the RJE source code. The most frequently occurring one is “cannot 
open /dev/vpm?’’. This may occur if the VPM script has not been started, or if another process already has 
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the VPM device open. 

Once RJE has been started, users should assist in monitoring its performance, and should notify operations 
personnel of any perceived need for remedial action. Rjestat{\C) will aid in diagnosing the current state of 
RJE. It can detect, with some reliability, when the far end of the communications line has gone dead, and 
will report in this case that the host computer is not responding to RJE. 
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NAME 

romboot - special ROM bootstrap loaders 

DESCRIPTION 

To bootstrap programs from various storage media, standard DEC ROM bootstrap loaders are often used. 
However, such standard loaders may not be compatible with the UNIX System bootstrap programs or may 
not exist on a particular system. Thus, special bootstrap loaders were designed that may be cut into a pro¬ 
grammable ROM (M792 read-only-memory) or manually toggled into memory. 

Each program is position-independent, that is, it may be located anywhere in memory. Normally, it is 
loaded into high core to avoid being overwritten. Each reads one block from drive 0 into memory starting 
at address 0 and then jumps to address 0. To minimize the size, each assumes that a system INIT was gen¬ 
erated prior to execution. Also, the address of one of the device registers is used to set the byte count regis¬ 
ter or word count register. In each case, this will read in at least 256 words, which is the maximum size of 
bootstrap programs. 

On disk devices, block 0 is read; on tape devices, one block from the current position. Thus, the tape 
should be positioned at the load point (endzone if DECtape) prior to booting. Also, the standard DEC boot¬ 
strap loader for magnetic tape may be emulated by positioning the tape at the load point and executing the 
bootstrap loader twice. 

By convention, on PDF 11/45 systems, address 773 000 is the start of a tape bootstrap loader, and 773 020 
the start of a disk bootstrap loader. The actual loaders used depend on the particular hardware 
configuration. 

SEE ALSO 

70boot(8), unixboot(8). 

CODE 

TCI 1 - DECtape 

012700 mov $tcba,r0 

177346 

010040 mov r0,-(r0) 

012740 mov $3,-(r0) 

000003 

105710 1: tstb (rO) 

002376 bge lb 

112710 movb $5,(r0) 

000005 

105710 1: tstb (rO) 

002376 bge lb 

005007 clr pc 

TUIO - Magnetic Tape 

012700 mov $mtcma,r0 

172526 

010040 mov r0,-(r0) 

012740 mov $60003,-(r0) 

060003 

105710 1: tstb (rO) 

002376 bge lb 

005007 clr pc 


/use tc addr for wc 
/read bn forward 

/wait for ready 

/read forward 

/wait for ready 

/transfer to zero 

/use mt addr for be 
/read, 800 bpi, 9 track 

/wait for ready 

/transfer to zero 
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TUI6 - Magnetic Tape 
012700 

mov 

$mtwc,r0 

172442 

012760 

mov 

$1300,30(r0) 

001300 

000030 

010010 

mov 

r0,(r0) 

012740 

mov 

$71-(rO) 

000071 

105710 1: 

tstb 

(rO) 

002376 

bge 

lb 

005007 

clr 

pc 

RK05 - Disk Pack 

012700 

mov 

$rkda,r0 

177412 

005040 

clr 

-(rO) 

010040 

mov 

rO-(rO) 

012740 

mov 

$5-(r0) 

000005 

105710 1: 

tstb 

(rO) 

002376 

bge 

lb 

005007 

clr 

pc 

RP03 - Disk Pack 

012700 

mov 

$rpmr,r0 

176726 

005040 

clr 

-(rO) 

005040 

clr 

-(rO) 

005040 

clr 

-(rO) 

010040 

mov 

rO-(rO) 

012740 

mov 

$5-(r0) 

000005 

105710 1: 

tstb 

(rO) 

002376 

bge 

lb 

005007 

clr 

pc 

RP04 - Disk Pack 

012700 

mov 

$rpcsl,r0 

176700 

012720 

mov 

$21,(rO)H- 

000021 

012760 

mov 

$10000,30(r0) 

010000 

000030 

010010 

mov 

r0,(r0) 

012740 

mov 

$71-(rO) 

000071 

105710 1: 

tstb 

(rO) 

002376 

bge 

lb 

005007 

clr 

pc 


/set 800 bpi, PDF format 

/use mt addr for wc 
/read 

/wait for ready 
/transfer to zero 

/use rk addr for wc 
/read 

/wait for ready 
/transfer to zero 


/use rp addr for wc 
/read 

/wait for ready 
/transfer to zero 

/read-in preset 
/set to 16-bits/word 

/use rp addr for wc 
/read 

/wait for ready 
/transfer to zero 
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NAME 

tapeboot - magnetic tape bootstrap program 

DESCRIPTION 

Tapeboot handles the problem of booting a PDP-11/45 or PDP-11/70 from a TUlO or TU16 tape transport. 
In both cases, the tape density is 800 bpi. The complete program fits in one 512 byte block, but is dupli¬ 
cated so that one copy resides in block 0 and another in block 1. Thus, both the standard DEC ROM boot¬ 
strap loaders and the special ROM loaders will work. For example, to create a boot tape, execute: 

cat /stand/tapeboot program-to-boot >/dev/mt0 

To boot from magnetic tape, read the first record of the tape into memory starting at address 0 and then 
jump to address 0, using a special ROM or some manual procedure (toggle in the program). The bootstrap 
program relocates itself to high core as specified when assembled (typically 24K words, maximum of 28K). 
It then determines whether to use the TUlO code or the TU16 code. The TUlO is used if the TMll com¬ 
mand register (772 522) exists and the function (bits<3:l>) is non-zero, otherwise the TU16 is used. It 
then types on the console UNIX tape boot loader, rewinds the tape, reads two blocks to skip past itself on 
the tape, clears memory, and reads the rest of the tape, to the tape mark, into memory starting at address 0. 
If address 0 contains 000 407, a UNIX a.out program is assumed and the first 8 words are stripped off by 
relocating the loaded program toward address 0. Finally, a jump to address 0 is done by executing 
jsr pc,*$0. 

If there is an error while reading the tape, the bootstrap program will type tape error and attempt to read 
the record again. 

EIUES 

/stand/tapeboot TU10/TU16 magtape bootstrap 
/usr/src/stand source directory 
SEE AUSO 

unixboot(8). 
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NAME 

trouble - trouble reporting system 

DESCRIPTION 

The first line of the /usr/lib/trouble/trsh file must have the correct company code for your site; a local 
modification is necessary. The trouble command will not run until this change is made. 

The official company codes are as follows: 

at AT&T 

bl Bell Labs 

cb Cincinnati Bell 

cd C&P of Washington 

cm C&P of Maryland 

cv C&P of Virginia 

cw C&P of West Virginia 

lb Illinois Bell 

11 AT&T Long Lines 

mb Michigan Bell 

ms Mountain States Telephone 

nb Indiana Bell 

ne New England Telephone 

nj New Jersey Bell 

nv Nevada Bell 

nw Northwestern Bell 

ny New York Telephone 

ob Ohio Bell 

pa Bell of Pennsylvania 

pn Pacific Northwest Bell 

pt Pacific Telephone & Telegraph 

sb Southern Bell 

sc South Central Bell 

sn Southern New England Telephone 

sw Southwestern Bell 

we Western Electric 

wt Wisconsin Telephone 

All trouble reports are archived in /usr/lib/trouble/tr.a; this file should be checked weekly to ensure that it 
does not get too large. If it gets too large, it should be moved to /usr/lib/trouble/otr.a; after a week or so, 
the old archive can be thrown away. 

The trouble login is intended to be used only for administering the trouble system. If uucp cannot deliver a 
trouble report, mail(l) will be returned to the trouble login. Any trouble reports not delivered may be 
retransmitted by using the trxmit command with the trouble report numbers as arguments. (Hence, the rea¬ 
son for saving the archive for a while.) 

The /usr/lib/trouble/names file can be expanded to include the names of additional people at your site. 

The per-line format of this file is as follows: 

letter-IDs(3-6) location phone name(with appropriate blanks) 

The above fields are separated by blanks and/or tabs. When the letter-ID is identified, the name, location 
and phone will be taken from this file (provided they have legal formats). Note that the name field is the 
only one that can have blanks. 

PILES 

/usr/lib/trouble/tr.a archived trouble reports 
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/usr/lib/trouble/instruct instructions 
/usr/lib/trouble/trsh trouble report shell 
/usr/lib/trouble/trxmit re-transmission shell 
/usr/lib/trouble/names letter ID data base 

SEE ALSO 

trouble(l), uucp(lC). 
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NAME 

unixboot - UNIX System startup and boot procedures 

DESCRIPTION 

How to start the UNIX System. The UNIX System is started by placing it in core at location zero and trans¬ 
ferring to zero. Since the system is not reenterable, it is necessary to read it in from disk or tape. See 
diskboot(8) or tapeboot(8). 

The switches. On systems with console switches, the switches are examined 60 times per second, and the 
contents of the address specified by the switches are displayed in the display register. If the switch address 
is even, the address is interpreted in kernel (system) space; if odd, the rounded-down address is interpreted 
in the current user space. 

Init. The operating system invokes init{\M) as process number 1. It comes up conventionally in single- 
user mode. 

EIUES 

/unix The UNIX System code 
SEE AUSO 

init(lM), 70boot(8), diskboot(8), romboot(8), tapeboot(8). 


Page 1 



